Ergebnisse simulieren (Test Mock)

MarkdownChatGPTClaude

In der Sandbox können Sie ein Prozessergebnis simulieren, ohne von einer echten biometrischen Erfassung abhängig zu sein. Fügen Sie das Feld expected_result zum Request-Body von Prozess erstellen hinzu — der Rest der Integration (SDK-Rendering, biometrische Erfassung, Prozess abrufen) bleibt exakt derselbe wie bei einem echten Flow.

Der Mock überspringt nicht den Schritt der biometrischen Erfassung. Der Nutzer (oder Ihr Testskript) muss weiterhin den normalen Flow durchlaufen — was sich ändert, ist, dass der Prozess nach Abschluss die in expected_result definierten Werte zurückgibt, anstatt des echten Auswertungsergebnisses.

Jeder flow akzeptiert abhängig von seiner Konfiguration nur eines der beiden folgenden Formate:

Format	Wann verwenden
id_cloud_one_result	Flows, die ein einzelnes Ergebnis zurückgeben (genehmigt, abgelehnt, hohes Risiko usw.)
authentication_info	Flows, die einzelne Signale zurückgeben (UnicoId, Trust, Liveness, IdAge, IdFace...)

Das Senden des Formats, das nicht zu Ihrem flow passt, oder das gleichzeitige Senden beider Formate führt zu einem Fehler — siehe Fehler.

Endpunkt

Umgebung	URL
Sandbox	POST https://api.idcloud.uat.unico.app/client/v1/process

Der Mock ist nur in der Sandbox verfügbar. In der Produktion wird das Feld expected_result abgelehnt.

Einzelnes Ergebnis — id_cloud_one_result

Verwenden Sie dies, wenn Ihr flow ein einzelnes Ergebnis im Genehmigungsstil zurückgibt.

Body-Parameter

Feld	Typ	Erforderlich	Beschreibung
expected_result.​id_cloud_one_result	string	ja	Das zu simulierende einzelne Ergebnis. Muss ein Ergebnis sein, das Ihr flow tatsächlich erzeugt — prüfen Sie die Konfiguration Ihres Flows auf die Ergebnisse, die er erkennt.

Beispiel

curl -X POST https://api.idcloud.uat.unico.app/client/v1/process \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_result": {
      "id_cloud_one_result": "PROCESS_RESULT_APPROVED"
    }
    // ... die übrigen Parameter sind dieselben, die Sie bei einem echten Aufruf von Prozess erstellen verwenden
  }'

Antwort (200 OK)

{
  "process": {
    "id": "53060f52-f146-4c12-a234-5bb5031f6f5b",
    "state": "PROCESS_STATE_FINISHED",
    "result": "PROCESS_RESULT_OK",
    "flow": "your-sandbox-flow",
    "simulated": true,
    "capacities": ["PROCESS_CAPACITY_IDCHECK"],
    "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909" }
  }
}

simulated: true kennzeichnet diesen Prozess als einen mit einem simulierten Ergebnis, nicht als echte Auswertung.

Die möglichen Werte von id_cloud_one_result sind dieselben Prozessergebniswerte, die unter Ergebnisse interpretieren dokumentiert sind — senden Sie nur ein Ergebnis, das Ihr flow tatsächlich erkennt.

Einzelne Signale — authentication_info

Verwenden Sie dies, wenn Ihr flow separate Signale anstelle eines einzelnen Ergebnisses zurückgibt.

Jedes Signal, das Ihr flow normalerweise zurückgibt, muss in authentication_info vorhanden sein. Das Senden nur einiger davon wird abgelehnt — Sie können nicht ein Signal mocken und den Rest der echten Auswertung überlassen.

trust_result vs. identity_fraudsters_result

trust_result und identity_fraudsters_result stellen dasselbe Signal dar (Hinweis auf Identitätsbetrug): trust_result deckt die negative Seite ab, identity_fraudsters_result die positive Seite. Verwenden Sie das jeweils passende Feld für das Ergebnis, das Sie simulieren möchten.

Die möglichen Werte der einzelnen Felder finden Sie unter Funktionsergebnisse in authenticationInfo.

Reibungslose Flows werden in diesem Format nicht unterstützt — siehe Nicht unterstützte Signale.

Beispiel

curl -X POST https://api.idcloud.uat.unico.app/client/v1/process \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_result": {
      "authentication_info": {
        "authentication_result": "AUTHENTICATION_RESULT_POSITIVE",
        "liveness_result": "LIVENESS_RESULT_LIVE",
        "id_age_result": "ID_AGE_RESULT_POSITIVE"
      }
    }
    // ... die übrigen Parameter sind dieselben, die Sie bei einem echten Aufruf von Prozess erstellen verwenden
  }'

Antwort (200 OK)

{
  "process": {
    "id": "53060f52-f146-4c12-a234-5bb5031f6f5b",
    "state": "PROCESS_STATE_FINISHED",
    "result": "PROCESS_RESULT_OK",
    "flow": "your-sandbox-flow",
    "simulated": true,
    "capacities": ["PROCESS_CAPACITY_IDUNICO", "PROCESS_CAPACITY_IDAGE"],
    "authenticationInfo": {
      "authenticationResult": "AUTHENTICATION_RESULT_POSITIVE",
      "livenessResult": "LIVENESS_RESULT_LIVE",
      "idAgeResult": "ID_AGE_RESULT_POSITIVE"
    },
    "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909" }
  }
}

Nicht unterstützte Signale

Die folgenden Signale werden vom Mock in keinem der beiden Formate unterstützt:

• multi_accounts
• data_mismatch
• serial_fraudster
• smart_revalidation_result
• passkey_result (veraltet)

Reibungslose Flows (Authentifizierung ohne biometrische Erfassung) werden nur im Format id_cloud_one_result unterstützt — sie funktionieren nicht mit authentication_info.

Hinweise zur Antwort

Der Score wird nur zurückgegeben, wenn das Identitätsergebnis nicht eindeutig ist. Das Feld score_engine_result enthält nur dann einen Wert, wenn authentication_result gleich AUTHENTICATION_RESULT_INCONCLUSIVE ist. Wenn Sie authentication_result als POSITIVE oder NEGATIVE zusammen mit einem von null verschiedenen score_engine_result mocken, gibt die endgültige Antwort score_enabled: SCORE_ENABLED_FALSE und score: 0 zurück, unabhängig vom gesendeten Wert.

Dies ist das normale Verhalten der API — dieselbe Regel gilt für echte Prozesse und ist nicht spezifisch für den Mock. Wenn das Szenario, das Sie testen möchten, davon abhängt, dass der Score in der Antwort erscheint, verwenden Sie authentication_result: AUTHENTICATION_RESULT_INCONCLUSIVE.

Fehler

Situation	Fehler
expected_result außerhalb der Sandbox	PERMISSION_DENIED
id_cloud_one_result und authentication_info zusammen gesendet	INVALID_ARGUMENT
Leeres authentication_info: {}	INVALID_ARGUMENT
authentication_info fehlt ein vom Flow zurückgegebenes Signal	Validierungsfehler — alle Signale angeben
Wert von id_cloud_one_result, den der Flow nicht erkennt	Validierungsfehler
flow unterstützt kein Mocking	Validierungsfehler

Nächste Schritte

Nachdem Sie den simulierten Prozess erstellt haben, schließen Sie die biometrische Erfassung normal ab und verwenden Sie Prozess abrufen, um das simulierte Ergebnis abzurufen.