Zum Hauptinhalt springen
POST
curl

Übersicht

Verwenden Sie diesen Endpoint, wenn Sie Benutzer von einem anderen Anbieter importieren und bereits für jede Person ein vertrauenswürdiges Gesichtsbild haben. Der Benutzer bleibt über Ihr vendor_data referenziert, aber dieser Endpoint zum Anhängen von Gesichtern an ein Profil verwendet didit_internal_id, damit der Zielbenutzer eindeutig ist.
Dies unterscheidet sich von Gesicht zur Liste hochladen. Der Profil-Upload hängt ein Gesicht als Nachweis an einen Benutzer an und wird für Duplikaterkennung und Gesichtssuche verwendet. Der Listen-Upload fügt ein Gesicht zu einer Sperrliste mit Gesichtern hinzu, damit künftige Matching-Sitzungen abgelehnt werden können.

Endpoint

POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/

Migrationsablauf

1

Benutzer anlegen oder finden

Rufen Sie POST /v3/users/create/ für ein neues Profil auf oder GET /v3/users/{vendor_data}/ für ein bestehendes Profil.
2

didit_internal_id speichern

Die Benutzerantwort enthält didit_internal_id. Verwenden Sie in Ihrer Datenbank weiterhin vendor_data; verwenden Sie didit_internal_id nur für Endpoints zum Anhängen von Gesichtern an ein Profil.
3

Gesicht hochladen

Senden Sie ein rohes Base64-kodiertes Bild im Feld image. Das Backend prüft vor dem Speichern die Bilddekodierung, die Bildgröße und die Gesichtserkennung.

Beispiel

Anfragetext

Antwort

Validierung und Limits

  • Maximal 5 manuell hochgeladene Gesichter pro Benutzer.
  • Die maximale dekodierte Bildgröße beträgt 2 MB.
  • Das Bild muss gültiges Base64 sein und sich als Bild dekodieren lassen.
  • Das Bild muss ein erkennbares Gesicht enthalten. Verwenden Sie nach Möglichkeit einen frontalen, gut ausgeleuchteten Gesichtsausschnitt.
  • Das hochgeladene Gesicht wird für künftige Duplikaterkennung und Gesichtssuche indexiert.
  • Das hochgeladene Gesicht wird nicht automatisch auf die Sperrliste gesetzt.

Profilgesichter auflisten oder löschen

Profilgesichter auflisten:
Ein Profilgesicht löschen:

Berechtigungen

Verwenden Sie einen API-Schlüssel derselben Anwendung. Der Schlüssel muss zu einer App gehören, die das Zielprofil des Benutzers verwalten darf.

Fehlerszenarien

  • 400: ungültiges Base64, ungültiges Bild, kein erkennbares Gesicht, Bild größer als 2 MB oder der Benutzer hat bereits 5 hochgeladene Gesichter.
  • 401: fehlende oder ungültige Zugangsdaten.
  • 403: Der API-Schlüssel ist gültig, darf dieses Benutzerprofil aber nicht verwalten.
  • 404: In der Anwendung existiert kein Benutzer für diese didit_internal_id.
  • 429: Rate-Limit erreicht; warten Sie gemäß Retry-After, bevor Sie es erneut versuchen.

Verwandte Seiten

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

organization_id
string<uuid>
erforderlich

UUID der Organisation, der die Anwendung gehört.

application_id
string<uuid>
erforderlich

UUID der Anwendung, zu der das Benutzerprofil gehört.

didit_internal_id
string<uuid>
erforderlich

Didits interne Benutzer-UUID, zurückgegeben als didit_internal_id von GET /v3/users/{vendor_data}/ und POST /v3/users/create/.

Body

application/json
image
string<byte>
erforderlich

Unverarbeitetes Base64-codiertes JPG- oder PNG-Gesichtsbild. Kein data:image/...;base64,-Präfix angeben. Maximale decodierte Größe: 2 MB.

comment
string
Standard:""

Optionale, für den Bearbeiter sichtbare Notiz zum hochgeladenen Gesicht.

Antwort

Gesicht hochgeladen und dem Benutzerprofil zugeordnet.

uuid
string<uuid>
erforderlich

UUID des hochgeladenen Benutzer-Gesichtsdatensatzes.

image_url
string<uri> | null
erforderlich

Signierte URL für das hochgeladene Gesichtsbild.

comment
string | null
erforderlich

Kommentar, der beim Hochladen des Gesichts angegeben wurde.

uploaded_by
string | null
erforderlich

E-Mail oder Akteurskennung des Uploaders, sofern verfügbar.

created_at
string<date-time>
erforderlich

Zeitstempel des Uploads.

Zuletzt geändert am 7. November 2026