---
title: Übersicht
description: Referenz für die IDCloud-APIs — zwei öffentliche Verträge (Web & SDK und API).
canonical: https://developer.unico.io/de/dual-api/developers/api-reference/
locale: de
generated_by: markdown-export
---

- [/de/](/de/)
- API-Referenz

**Auf dieser Seite# Übersicht

### Einen Vertrag auswählen​

Die Wahl des Vertrags ergibt sich aus **dem Ort, an dem die biometrische Erfassung stattfindet** — keine unabhängige Entscheidung. Verwenden Sie die folgende Tabelle als Orientierung.
VertragVerwenden wenn…ErfassungFlow**[Web & SDK](/de/dual-api/developers/api-reference/web-sdk)**Der Erfassungsprozess wird von Unico gehostet (Web iFrame, Redirect oder natives SDK)Unico steuertProzess wird **vor** der Erfassung erstellt → Benutzer durchläuft den Prozess → Ergebnis wird per Callback oder Polling zurückgegeben**[API](/de/dual-api/developers/api-reference/api)**Ihre Anwendung steuert die Erfassung (mit oder ohne das Unico SDK) und sendet das Bild direkt im AufrufClient steuertBild wird **zusammen** mit der Prozesserstellung gesendet → Ergebnis wird synchron zurückgegeben
### Hosts und Umgebungen​

VertragSandbox-HostProduktions-HostWeb & SDK`https://api.idcloud.uat.unico.app``https://api.idcloud.unico.app`API`https://api.id.uat.unico.app``https://api.id.unico.app`OAuth2 / Token`https://identityhomolog.acesso.io``https://identity.acesso.io`
Vollständige Details unter [Umgebungen](/de/dual-api/developers/api-reference/environments).
### Authentifizierung​

Alle Unico-Verträge verwenden ein **Bearer-Token (JWT)**, das über OAuth2 mit `urn:ietf:params:oauth:grant-type:jwt-bearer` abgerufen wird.
Vollständige Details unter [Authentifizierung](/de/dual-api/developers/api-reference/authentication).
### Payload-Unterschiede zwischen Verträgen​

Derselbe konzeptuelle Vorgang („einen Identitätsverifizierungsprozess erstellen") sieht in jedem Vertrag unterschiedlich aus. Verwenden Sie die folgenden Tabellen als schnelle Referenz beim Wechsel zwischen Integrationen.
Prozesserstellung
AspektWeb & SDKAPI**Endpoint**`POST /client/v1/process``POST /processes/v1`**Auth**`Authorization: Bearer <jwt>``Authorization: Bearer <jwt>` + `APIKEY`**Bild**Nicht gesendet (von Uniccos Journey erfasst)Als `imageBase64` gesendet**Benutzeridentifikation**`person.duiType` + `person.duiValue``subject.code` (CPF / CURP)**Dokumenttypen**CPF, CURP, SSN, NIN, DNI, NIKNur CPF, CURP**Pipeline-Definition**`flow` (Enum, 30+ Werte)Implizit im `APIKEY` (Funktionen)**Callback**`callbackUri` (Benutzerweiterleitung)Keiner (synchron)**Webhook**Webhook v1 (Endergebnis)Webhook v1 (optional)**Gibt Journey-URL zurück**Ja (`userRedirectUrl`)Nein**Ergebnis**Asynchron (GET-Polling oder Webhook)Synchron (in der Antwort)**SDK-Token**Ja (`token`, `webAppToken`)Nein
Ergebnisabruf
AspektWeb & SDKAPI**Endpoint**`GET /client/v1/process/\{id\}``GET /processes/v1/\{id\}` (auch in der Erstellungsantwort)**Status**`state` + `result` (Enums mit Präfix)`status` (1, 3, 5)**Ergebnisstruktur**Verschachtelt unter `process.authenticationInfo.{capability}Result`. In Mexiko `idGov` unter `authenticationInfo`.Flach: `unicoId`, `liveness`, `government`, `identityFraudsters`, `idGov` (nur Mexiko)**Dokument**`services[].documents[]` (RG/CNH mit OCR)Separater Endpoint (`GET /processes/v1/\{id\}/document`)
### Nächste Schritte​

[Authentifizierung](/de/dual-api/developers/api-reference/authentication) — OAuth2-Flow und JWT-Generierung
[Umgebungen](/de/dual-api/developers/api-reference/environments) — Sandbox vs. Produktion
[Postman-Sammlung](/de/dual-api/developers/api-reference/postman) — sofort einsatzbereite Sammlungen
[Webhooks und Ereignisse](/de/developers/webhooks-and-events) — asynchrone Ergebnislieferung
[SDKs und Tools](/de/developers/sdks-and-tools/overview) — Web SDK, Android, iOS, Flutter
Zuletzt aktualisiert am 8. Okt. 2026**