---
title: Gestion des erreurs
canonical: https://developer.unico.io/fr/dual-api/developers/sdks-and-tools/web/web-sdk/error-handling
locale: fr
generated_by: markdown-export
---

Toute la gestion des erreurs du Web SDK est centralisée dans cette section. Le callback `error` reçoit un objet `ErrorBio` exposant `getCode()` et `getDescription()`.

## Erreurs prepareCamera

| Code | Description |
|---|---|
| `73000` | Erreur inconnue et inattendue lors de l'utilisation normale des API du SDK |
| `73001` | `<property>` est requise |
| `73002` | `<property>` doit être une instance de `<class>` |
| `73003` | `<class>` avec le nom `<name>` n'est pas disponible pour l'injection |
| `73004` | Le type de classe doit être une fonction ou une classe |
| `73005` | Impossible de trouver la locale `<locale>` |
| `73006` | Impossible de trouver le texte : `<text>` |
| `73100` | Impossible de se connecter à Internet |
| `73200` | Impossible de trouver le fichier JSON du SDK Unico |
| `73201` | Impossible de charger le fichier JSON du SDK Unico |
| `73202` | Le fichier JSON du SDK Unico est invalide |
| `73204` | Impossible d'initialiser le SDK — configurez l'environnement via `setEnvironment` lors de la construction |
| `73300` | Impossible d'authentifier cette application |
| `73301` | Impossible d'authentifier cette application |
| `73302` | Token d'authentification introuvable |
| `73303` | L'hôte actuel n'est pas enregistré |
| `73400` | Impossible d'initialiser la caméra |
| `73401` | Impossible de charger les modèles ML pour cette caméra |
| `73402` | La clé n'a pas pu être vérifiée en raison de problèmes de connectivité sur l'appareil de l'utilisateur |
| `73403` | Cette combinaison appareil/plateforme/navigateur/version n'est pas prise en charge par le SDK |
| `73404` | L'appareil est en orientation paysage. Le SDK ne peut être utilisé qu'en mode portrait |
| `73405` | Appareil bloqué en raison de plusieurs tentatives échouées |
| `73406` | L'initialisation de la caméra a été bloquée — le SDK a été ouvert dans un iFrame lors de `prepareCamera` |
| `73407` | Le SDK n'a pas été entièrement chargé |
| `73500` | Impossible d'obtenir la session |
| `73501` | Impossible d'obtenir la session |
| `73502` | Token de session introuvable |
| `73600` | Impossible de trouver la ressource caméra |
| `73601` | Impossible de démarrer la caméra en mode production |
| `74000` | Hexadécimal invalide |
| `74001` | L'objet n'est pas un `UnicoTheme` |

## Erreurs openCamera

| Code | Description |
|---|---|
| `73700` | Impossible d'analyser la réponse de la caméra |
| `73704` | L'utilisateur a appuyé sur le bouton annuler et n'a pas complété la session |
| `73706` | Accès à la caméra refusé — l'utilisateur a explicitement refusé la permission ou la politique de l'appareil la bloque |
| `73707` | La session a été annulée en raison de la fermeture de l'application, d'une mise en veille, d'une notification du système d'exploitation ou d'un passage en arrière-plan |
| `73708` | La session a été annulée car l'appareil est en mode paysage |
| `73710` | La session a été annulée car l'utilisateur n'a pas pu la compléter dans le délai imparti |
| `73715` | La session a été annulée car toutes les images de guidage n'étaient pas configurées |
| `73716` | La session a été annulée car le SDK n'a pas pu démarrer la caméra sur cet appareil |
| `73717` | La session a été annulée car l'utilisateur se trouvait dans un état de verrouillage |
| `73718` | Erreur inconnue et inattendue lors de l'utilisation normale des API du SDK |
| `73720` | Le développeur a annulé la session par programmation via l'API d'annulation |
| `73721` | La session a été annulée en raison d'un changement d'orientation de l'appareil pendant la session |
| `73722` | La session a été annulée car le document n'est pas prêt |
| `73723` | La session a été annulée car une autre session était en cours |
| `73724` | La session active a été annulée car la session caméra a démarré dans un iFrame |
| `73728` | Erreur de connexion — veuillez utiliser HTTPS pour vous connecter |
| `73729` | Navigateur non pris en charge — veuillez ouvrir dans un autre navigateur |
| `73730` | Impossible d'initialiser une session de liveness active — erreur de licence inconnue |
| `73731` | Impossible d'initialiser une session de liveness active — licence expirée |
| `73732` | Impossible d'initialiser une session de liveness active — l'origine n'est pas autorisée |
| `73750` | La capture a échoué car les yeux de l'utilisateur étaient fermés |
| `73760` | La capture a échoué à cause de l'éclairage de l'environnement (trop sombre, trop clair ou inégal) |
| `73761` | La capture a échoué à cause de la distance entre le visage de l'utilisateur et l'écran (trop près ou trop loin) |
| `73762` | La capture a échoué car des lunettes ou des accessoires couvrent le visage de l'utilisateur |
| `73763` | La capture a échoué car le visage de l'utilisateur n'était pas stable ou aligné |
| `73764` | La capture a échoué à cause du cadrage du visage (visage décentré, plusieurs visages ou arrière-plan chargé) |
| `73800` | Impossible de chiffrer la réponse |
| `73900` | Impossible d'obtenir les informations système |

:::secondary[Catalogue officiel des erreurs]
Les codes ci-dessus reflètent le catalogue du Web SDK. Le catalogue officiel des codes d'erreur multiplateforme est disponible dans [Référence API > Codes d'erreur](/dual-api/developers/api-reference/error-codes).
:::

## Gestion du callback

```javascript
const callback = {
  on: {
    success: (obj) => {
      console.log(obj.base64);
      console.log(obj.encrypted);
    },
    error: (error) => {
      const code = error.getCode();
      const description = error.getDescription();
      // handle error
    }
  }
};
```

:::danger[Callback obligatoire]
L'objet `callback` est obligatoire. S'il n'est pas correctement implémenté (en couvrant les événements `success` et `error`), le SDK lève une exception qui, si elle n'est pas gérée, s'affiche dans la console de l'utilisateur.
:::