Ergebnis empfangen

Das SDK gibt das Aufnahmeergebnis über das callback-Objekt zurück, das an open() übergeben wird. Sowohl der success- als auch der error-Handler sind obligatorisch.

Selfie-Aufnahme

success (Selfie)

Wird aufgerufen, wenn das Bild erfolgreich aufgenommen wurde. Empfängt ein Objekt mit:

• base64 — aufgenommenes Bild; kann verwendet werden, um eine Vorschau in Ihrer Anwendung anzuzeigen.
• encrypted — JWT-Nutzlast, die an Ihr Backend gesendet werden muss, um die biometrische Validierung über die REST-API abzuschließen.

const callback = {
  on: {
    success: (obj) => {
      const base64 = obj.base64;
      const encrypted = obj.encrypted; // JWT to send to your backend
    },
    error: (error) => {
      console.error(error);
    }
  }
};

Verwendung von encrypted

• Das Attribut encrypted ist ausschließlich für die Übermittlung des Bildes über die Client-APIs vorgesehen. Es darf nicht geöffnet oder serialisiert werden — seine Eigenschaften können sich ohne vorherige Ankündigung ändern. Unico übernimmt keine Haftung für Schäden, die durch unsachgemäßen Umgang entstehen.
• Die Dateien base64/encrypted können je nach Gerätequalität, generierter Fotogröße und den Geschäftsregeln von Unico in der Größe variieren. Begrenzen Sie nicht die Größe der vom SDK generierten Zeichenkette in Ihrer Programmierlogik oder Infrastruktur.

error (Selfie)

Wird aufgerufen, wenn während der Aufnahme ein Fehler auftritt. Empfängt ein ErrorBio-Objekt mit getCode() und getDescription(). Die vollständige Liste der Fehlercodes finden Sie unter Fehlerbehandlung.

error: (error) => {
  const code = error.getCode();
  const description = error.getDescription();
}

Dokumentenaufnahme

success (Dokument)

Wird aufgerufen, wenn das Dokumentbild erfolgreich aufgenommen wurde. Empfängt ein Objekt mit:

• base64 — aufgenommenes Bild; kann zur Anzeige einer Vorschau verwendet werden.
• encrypted — JWT-Nutzlast, die innerhalb von 10 Minuten an Ihr Backend gesendet werden muss und niemals geändert oder deserialisiert werden darf.

const callback = {
  on: {
    success: (obj) => {
      const base64 = obj.base64;
      const encrypted = obj.encrypted;
    },
    error: (error) => { /* ... */ }
  }
};

error (Dokument)

Wird aufgerufen, wenn während der Dokumentenaufnahme ein Fehler auftritt. Empfängt ein ErrorBio-Objekt. Die vollständige Liste der Fehlercodes finden Sie unter Fehlerbehandlung.