Zum Hauptinhalt springen
POST
Prüft Eingabedaten gegen eine staatliche Behörde. Didit stellt diesen Service über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Übereinstimmungsergebnisse erhalten.

Abdeckung

  • Abdeckung: ~ 90%
  • Land: Indonesien
  • Service-ID: idn_residential_identity_card
  • Datenbereich: Adresse
  • Kategorie: Wohnsitz

Eingaben

  • Pflichteingaben: full_name, date_of_birth, national_id, address.street_1, address.postal_code
  • Optionale Eingaben: address.street_2, address.city, address.region, gender, vendor_data
  • Einwilligung: Erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~ 90%
  • Preis: $0.35 pro erfolgreicher Abfrage
Nicht jedes Dokument, das dieser Service akzeptiert, enthält den Identifikator, über den abgefragt wird. Wird der Identifikator nicht aus dem Dokument extrahiert, wird die Prüfung als nicht zutreffend erfasst. Dabei wird keine Datenbank abgefragt und Ihnen wird nichts berechnet. In einigen Ländern betrifft dies einen großen Anteil realer Benutzer. Um auch sie abzudecken, erfassen Sie den Identifikator zusätzlich über eine Fragebogenantwort, ein Document-AI-Extraktionsfeld oder einen Wert, den Sie beim Erstellen der Sitzung übermitteln, und ordnen Sie ihn im Schritt Datenbankvalidierung zu.

Body-Parameter

string
Standard:"IDN"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankservice.Beispiel: IDN
string
Standard:"idn_residential_identity_card"
erforderlich
Array, das diese Service-ID enthält. Durch das Festlegen des Service bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: idn_residential_identity_card
Ausdrückliche Einwilligung des Endbenutzers für diesen Service.Beispiel: true
string
Standard:"John Doe"
erforderlich
Vollständiger amtlicher Name, der validiert werden soll.Beispiel: John Doe
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Standard:"1111111111111111"
erforderlich
Nationale Identitätsnummer für diesen Service.Beispiel: 1111111111111111
object
erforderlich
Strukturiertes Objekt für die Wohnadresse. Verwenden Sie street_1, street_2, city, region, postal_code und country. Eine vollständige Adresszeichenfolge im alten Format wird weiterhin akzeptiert, wird 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
Geschlechtsangabe, sofern die Datenbank sie erfordert.Zulässige Werte: M (männlich), F (weiblich), X (anderes oder unbekannt).Beispiel: M
string
Standard:"user-1234"
Ihre dauerhafte Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und unnötige Meldungen bei der Duplikaterkennung zu reduzieren.Beispiel: user-1234

Eingaberegeln und Validierungshinweise

  • national_id darf nur Ziffern enthalten. Entfernen Sie vor dem Senden der Anfrage Leerzeichen, Bindestriche und Satzzeichen.
  • national_id muss genau 16 Zeichen lang sein.
  • Verwenden Sie bei Adressservices nach Möglichkeit strukturierte Adressfelder statt einer einzelnen address-Zeichenfolge.
  • address.street_1 ist die Straßenadresse einschließlich Hausnummer und Straßentyp.
  • address.street_2 bezeichnet eine Wohnung, Einheit, ein Gebäude, eine Etage oder eine zusätzliche Adresszeile. Senden Sie sie nur, wenn Sie diese Angabe haben.
  • address.city bezeichnet eine Stadt, einen Vorort, einen Bezirk, eine Ortschaft oder einen Stadtteil.
  • address.region bezeichnet einen Bundesstaat, eine Provinz, eine Region oder einen Ort.
  • address.postal_code ist die Postleitzahl.
  • Adressbasierte Datenbankservices erfordern mindestens Straßenadresse und Postleitzahl. Anfragen, die vor der Abfrage der Quelle abgelehnt werden, werden nicht berechnet.

So rufen Sie es auf

Zurückgegebene Daten

Welche Felder genau in source_data ausgegeben werden, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für idn_residential_identity_card dokumentiert derzeit diese normalisierte Form:
  • address_match_score
  • date_of_birth
  • identification_number

Preise & SLAs

Abfragen für Indonesia Residential Identity Card werden nur abgerechnet, wenn Didit ein schlüssiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Aufruf: $0.35 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Ihnen werden keine Kosten berechnet, 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