Zum Hauptinhalt springen
POST
Prüft Eingabedaten gegen eine Datenbank einer Regierungsbehörde mit Daten malaysischer Staatsbürger. 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: > 75%
  • Land: Malaysia
  • Dienst-ID: mys_national_id
  • Datendomäne: Identität
  • Kategorie: NationalIDRegistry

Eingaben

  • Pflichtfelder: full_name, date_of_birth, national_id
  • Optionale Felder: address.street_1, address.street_2, address.city, address.region, address.postal_code, phone, vendor_data
  • Einwilligung: Erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: > 75%
  • Preis: $0.59 pro erfolgreiche Abfrage
Nicht jedes Dokument, das dieser Dienst akzeptiert, enthält den Identifikator, mit dem abgefragt wird. Wenn der Identifikator nicht aus dem Dokument extrahiert wird, wird die Prüfung als nicht zutreffend erfasst: Es wird keine Datenbank abgefragt, und Ihnen wird nichts berechnet. Für manche Länder betrifft das einen großen Anteil der tatsächlichen Nutzer. Um diese Nutzer abzudecken, erfassen Sie den Identifikator zusätzlich über eine Antwort aus einem Fragebogen, ein Extraktionsfeld von Document AI oder einen Wert, den Sie beim Erstellen der Sitzung übermitteln, und ordnen Sie ihn im Schritt „Datenbankvalidierung“ zu.

Body-Parameter

string
Standard:"MYS"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: MYS
string
Standard:"mys_national_id"
erforderlich
Array mit der ID dieses Dienstes. Die Festlegung des Dienstes hält die Anfrage auf genau diese Datenbank beschränkt.Beispiel: mys_national_id
Ausdrückliche Einwilligung des Endbenutzers für diesen Dienst.Beispiel: true
string
Standard:"John Doe"
erforderlich
Vollständiger amtlicher Name zur Validierung.Beispiel: John Doe
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Standard:"111111111111"
erforderlich
Nationale Identitätsnummer für diesen Dienst.Beispiel: 111111111111
object
Strukturiertes Objekt für die Wohnadresse. Verwenden Sie street_1, street_2, city, region, postal_code und country. Eine vollständige Legacy-Adresszeichenkette 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
Telefonnummer im internationalen Format.Beispiel: +15550101000
string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, zum Beispiel Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen derselben Endbenutzer zuzuordnen und Fehlalarme bei der Dublettenerkennung zu verringern.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 übermitteln Sie die strukturierten Felder explizit.
  • national_id darf nur Ziffern enthalten. Entfernen Sie Leerzeichen, Bindestriche und Satzzeichen, bevor Sie die Anfrage senden.
  • national_id muss genau 12 Zeichen lang sein.
  • Verwenden Sie bei Adressdiensten 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 das Feld nur, wenn Sie diese Angabe haben.
  • address.city ist Stadt, Vorort, Bezirk, Ortschaft oder Stadtteil.
  • address.region ist Bundesstaat, Provinz, Region oder Stadt.
  • address.postal_code ist die Postleitzahl.
  • Adressbasierte Datenbankdienste erfordern mindestens Straßenadresse und Postleitzahl. Anfragen, die vor der Quellenabfrage abgelehnt werden, werden nicht berechnet.

So rufen Sie sie auf

Zurückgegebene Daten

Welche Felder konkret in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für mys_national_id dokumentiert derzeit diese normalisierte Struktur:
  • address
  • address_match_score
  • city
  • date_of_birth
  • identification_number
  • postal_code
  • state
  • street

Preise und SLAs

Abfragen der malaysischen nationalen ID werden nur abgerechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Aufruf: $0.59 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Sie zahlen nichts, wenn das Register nicht erreichbar ist, wenn erforderliche Felder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typisch 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