Fehlerbehandlung

Die gesamte Fehlerbehandlung für das Web SDK ist in diesem Abschnitt zusammengefasst. Der error-Callback empfängt ein ErrorBio-Objekt, das getCode() und getDescription() bereitstellt.

prepareCamera-Fehler

Code	Beschreibung
`73000`	Unbekannter und unerwarteter Fehler bei der normalen Verwendung der SDK-APIs
`73001`	`<property>` ist erforderlich
`73002`	`<property>` muss eine Instanz von `<class>` sein
`73003`	`<class>` mit dem Namen `<name>` ist nicht zum Injizieren verfügbar
`73004`	Klassentyp muss eine Funktion oder eine Klasse sein
`73005`	Die Locale `<locale>` wurde nicht gefunden
`73006`	Text nicht gefunden: `<text>`
`73100`	Keine Internetverbindung möglich
`73200`	Die Unico SDK JSON-Datei wurde nicht gefunden
`73201`	Die Unico SDK JSON-Datei konnte nicht geladen werden
`73202`	Die Unico SDK JSON-Datei ist ungültig
`73204`	SDK konnte nicht initialisiert werden — konfigurieren Sie die Umgebung über `setEnvironment` beim Build
`73300`	Diese Anwendung konnte nicht authentifiziert werden
`73301`	Diese Anwendung konnte nicht authentifiziert werden
`73302`	Authentifizierungstoken nicht gefunden
`73303`	Aktueller Host ist nicht registriert
`73400`	Kamera konnte nicht initialisiert werden
`73401`	ML-Modelle für diese Kamera konnten nicht geladen werden
`73402`	Der Schlüssel konnte aufgrund von Verbindungsproblemen auf dem Gerät des Benutzers nicht verifiziert werden
`73403`	Diese Kombination aus Gerät/Plattform/Browser/Version wird vom SDK nicht unterstützt
`73404`	Gerät befindet sich im Querformat. Das SDK kann nur im Hochformat verwendet werden
`73405`	Gerät aufgrund mehrerer fehlgeschlagener Versuche gesperrt
`73406`	Die Sitzung wurde abgebrochen — das SDK wurde in einem iFrame geöffnet
`73407`	Das SDK wurde nicht vollständig geladen
`73500`	Sitzung konnte nicht abgerufen werden
`73501`	Sitzung konnte nicht abgerufen werden
`73502`	Sitzungstoken nicht gefunden
`73600`	Kameraressource nicht gefunden
`73601`	Kamera konnte im Produktionsmodus nicht gestartet werden
`74000`	Ungültiger Hexadezimalwert
`74001`	Objekt ist kein `UnicoTheme`

openCamera-Fehler

Code	Beschreibung
`73700`	Kameraantwort konnte nicht verarbeitet werden
`73704`	Der Benutzer hat die Abbruch-Schaltfläche gedrückt und die Sitzung nicht abgeschlossen
`73706`	Kamerazugriff verweigert — Benutzer hat die Berechtigung ausdrücklich abgelehnt oder Geräterichtlinie blockiert diese
`73707`	Die Sitzung wurde abgebrochen, weil die App beendet wurde, in den Ruhezustand ging, eine OS-Benachrichtigung eintrat oder sie in den Hintergrund wechselte
`73708`	Die Sitzung wurde abgebrochen, weil sich das Gerät im Querformat befindet
`73710`	Die Sitzung wurde abgebrochen, weil der Benutzer sie nicht innerhalb der vorgesehenen Zeit abschließen konnte
`73715`	Die Sitzung wurde abgebrochen, weil nicht alle Führungsbilder konfiguriert wurden
`73716`	Die Sitzung wurde abgebrochen, weil das SDK die Kamera auf diesem Gerät nicht starten konnte
`73717`	Die Sitzung wurde abgebrochen, weil sich der Benutzer in einem gesperrten Zustand befand
`73718`	Unbekannter und unerwarteter Fehler bei der normalen Verwendung der SDK-APIs
`73720`	Der Entwickler hat die Sitzungsabbruch-API programmatisch aufgerufen
`73721`	Die Sitzung wurde aufgrund einer Änderung der Geräteausrichtung während der Sitzung abgebrochen
`73722`	Die Sitzung wurde abgebrochen, weil das Dokument nicht bereit ist
`73723`	Die Sitzung wurde abgebrochen, weil eine andere Sitzung lief
`73724`	Die Sitzung wurde abgebrochen, weil die Kamera in einem iFrame geöffnet wurde
`73728`	Verbindungsfehler — bitte verwenden Sie HTTPS
`73729`	Browser nicht unterstützt — bitte in einem anderen Browser öffnen
`73730`	Eine aktive Liveness-Sitzung konnte nicht initialisiert werden — unbekannter Lizenzfehler
`73731`	Eine aktive Liveness-Sitzung konnte nicht initialisiert werden — Lizenz abgelaufen
`73732`	Eine aktive Liveness-Sitzung konnte nicht initialisiert werden — Ursprung ist nicht zulässig
`73800`	Antwort konnte nicht verschlüsselt werden
`73900`	Systeminformationen konnten nicht abgerufen werden

Offizieller Fehlerkatalog

Die oben genannten Codes entsprechen dem Web-SDK-Katalog. Der offizielle plattformübergreifende Fehlercode-Katalog ist unter API-Referenz > Fehlercodes verfügbar.

Callback verarbeiten

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
    }
  }
};

Obligatorischer Callback

Das callback-Objekt ist obligatorisch. Wenn es nicht ordnungsgemäß implementiert ist (d. h. beide Ereignisse success und error abdeckt), löst das SDK eine Ausnahme aus, die, wenn sie nicht behandelt wird, in der Konsole des Benutzers angezeigt wird.