Übersicht
Dieser Abschnitt dokumentiert den API-Vertrag (intern als TCA / Check.Integration bekannt), der verwendet wird, wenn die Client-Anwendung den Aufnahmeschritt selbst übernimmt und das Bild direkt an die Plattform sendet.
Verwenden Sie den API-Vertrag, wenn:
- Ihre Anwendung das Selfie oder Bild bereits aufgenommen hat (über das native SDK von Unico oder einen proprietären Stack — Capture Standard).
- Sie synchrone Ergebnisse direkt in der Prozesserstellungsantwort benötigen.
- Sie den Benutzer nicht zu einer gehosteten Journey weiterleiten möchten.
- Ihre Architektur traditionelle Server-zu-Server-Aufrufe bevorzugt (Anfrage → Antwort mit dem Ergebnis).
Wenn Unico die Journey hosten soll, verwenden Sie stattdessen Web & SDK.
Erstellen Sie einen Verifizierungsprozess, indem Sie das aufgenommene Bild direkt senden. Gibt ein synchrones Ergebnis zurück.
Rufen Sie einen vorhandenen API-Vertragsprozess anhand seiner Kennung ab.
Prüfen Sie, ob ein Benutzer bereits ein wiederverwendbares Dokument gespeichert hat, bevor ein neuer Erfassungsablauf gestartet wird.
Ein neues Dokument erfassen oder ein zuvor erfasstes, das mit einem biometrischen Prozess verknüpft ist, wiederverwenden.
Registrierungsdaten, PEP/AML-Screening und Sportbeziehung für eine bestimmte CPF abfragen.
Native Bibliotheken für Android, iOS und Flutter zur Aufnahme des Selfies innerhalb Ihrer mobilen Anwendung.
Technische Anforderungen, die Ihre proprietäre Aufnahme erfüllen muss, wenn Sie das SDK von Unico nicht verwenden — Auflösung, Format, Beleuchtung und mehr.
Unterschiede zu Web & SDK
| Aspekt | API | Web & SDK |
|---|---|---|
| Zeitpunkt der Prozesserstellung | Nach der Aufnahme | Vor der Aufnahme |
| Bildrückgabe | Sofort (nach clientseitiger Aufnahme) | Über einen dedizierten Endpunkt |
| Journey-Steuerung | Client | Unico |
| Aufnahmesteuerung | Client (mit oder ohne SDK) | Unico |
| Identifikation | subject.code | person.duiType + person.duiValue |
| Header | Authorization + APIKEY | Nur Authorization |
| Ergebnisschema | Flach (unicoId.result, liveness usw.) | Verschachtelt (process.authenticationInfo.*Result) |
Nächste Schritte
- Prozess erstellen — vollständiger Onboarding-Vertrag.
- Fehlercodes — Umgang mit 4xx- und 5xx-Antworten.