Zum Hauptinhalt springen
POST
Prüft Eingabedaten gegen eine Datenbank einer staatlichen Behörde mit den Identitätsdaten von Staatsbürgern. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Übereinstimmungsergebnisse erhalten.

Abdeckung

  • Abdeckung: ~ 80%
  • Land: Kambodscha
  • Service-ID: khm_national_id
  • Datenbereich: Identität
  • Kategorie: NationalIDRegistry

Eingaben

  • Pflichteingaben: first_name, last_name, date_of_birth, voter_id
  • Optionale Eingaben: gender, address.street_1, address.street_2, address.city, address.region, address.postal_code, vendor_data
  • Einwilligung: erforderlich
  • Verfügbarkeit im Workflow: im Workflow verfügbar
  • Abdeckung: ~ 80%
  • Preis: $0.59 pro erfolgreicher Abfrage
Nicht jedes Dokument, das dieser Dienst akzeptiert, enthält den Identifikator, über den er abfragt. Wird der Identifikator nicht aus dem Dokument extrahiert, wird die Prüfung als nicht anwendbar erfasst: Es wird keine Datenbank abgefragt, und Ihnen wird nichts berechnet. Bei manchen Ländern betrifft das einen großen Teil der realen Benutzer. Um diese Benutzer abzudecken, erfassen Sie den Identifikator zusätzlich aus einer Antwort in einem Fragebogen, aus einem Extraktionsfeld von Document AI oder aus einem Wert, den Sie beim Erstellen der Sitzung übergeben, und ordnen ihn im Schritt Datenbankvalidierung zu.

Body-Parameter

string
Standard:"KHM"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: KHM
string
Standard:"khm_national_id"
erforderlich
Array mit der ID dieses Dienstes. Wenn Sie den Dienst festlegen, bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: khm_national_id
Ausdrückliche Einwilligung des Endbenutzers für diesen Dienst.Beispiel: true
string
Standard:"John"
erforderlich
Zu validierender Vorname.Beispiel: John
string
Standard:"Doe"
erforderlich
Zu validierender Nachname.Beispiel: Doe
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Standard:"12345678"
erforderlich
Wählerkennung.Beispiel: 12345678
string
Geschlechtsangabe, sofern die Datenbank sie erfordert.Zulässige Werte: M (männlich), F (weiblich), X (andere oder unbekannt).Beispiel: M
object
Strukturiertes Objekt für die Wohnadresse. Verwenden Sie street_1, street_2, city, region, postal_code und country. Eine vollständige Legacy-Adresse als einzelne Zeichenkette wird weiterhin akzeptiert, ist aber nicht empfohlen.Beispiel: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen desselben Endbenutzers zuzuordnen und unnötige Duplikatmeldungen zu reduzieren.Beispiel: user-1234

Eingaberegeln und Validierungshinweise

  • address ist für diesen Dienst optional. Sie können eine vollständige address-Zeichenkette senden, und Didit zerlegt sie nach Möglichkeit in strukturierte Adressbestandteile. Alternativ können Sie die strukturierten Felder explizit übergeben.
  • voter_id muss (?:\d{8,9}|\d{2}-\d{3}-\d{3}) entsprechen.
  • Bei Adressdiensten senden Sie nach Möglichkeit strukturierte Adressfelder statt einer einzelnen address-Zeichenkette.
  • address.street_1 ist die Straßenadresse einschließlich Hausnummer und Straßentyp.
  • address.street_2 ist Wohnung, Einheit, Gebäude, Etage oder eine zusätzliche Adresszeile. Senden Sie es nur, wenn Ihnen diese Angabe vorliegt.
  • address.city ist Stadt, Vorort, Bezirk, Ortschaft oder Stadtteil.
  • address.region ist Bundesstaat, Provinz, Region oder Ort.
  • address.postal_code ist die Postleitzahl.
  • Adressbasierte Datenbankdienste erfordern mindestens Straßenadresse und Postleitzahl. Anfragen, die vor der Abfrage der Quelle abgelehnt werden, werden nicht berechnet.

So wird die Anfrage gestellt

Zurückgegebene Daten

Welche Felder in source_data angezeigt werden, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für khm_national_id dokumentiert derzeit dieses normalisierte Format:
  • address
  • address_match_score
  • building_number
  • city
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score
  • state
  • street

Preise & SLAs

Abfragen der Cambodia National ID werden nur abgerechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Aufruf: $0.59 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Es fallen keine Kosten an, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischerweise p95 < 2 s.
  • Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit. Die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026