Zum Hauptinhalt springen
POST
Prüft Eingabedaten gegen eine Behördendatenbank mit Daten philippinischer 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 können.

Abdeckung

  • Abdeckung: > 80%
  • Land: Philippinen
  • Service-ID: phl_residential
  • Datenbereich: Adresse
  • Kategorie: Wohnsitz

Eingaben

  • Pflichteingaben: first_name, last_name, date_of_birth
  • Optionale Eingaben: 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 erfolgreiche Abfrage

Body-Parameter

string
Standard:"PHL"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: PHL
string
Standard:"phl_residential"
erforderlich
Array mit der Service-ID dieses Dienstes. Durch die Festlegung des Dienstes bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: phl_residential
Ausdrückliche Einwilligung des Endbenutzers für diesen Dienst.Beispiel: true
string
Standard:"John"
erforderlich
Zu prüfender Vorname.Beispiel: John
string
Standard:"Doe"
erforderlich
Zu prüfender Nachname.Beispiel: Doe
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
object
Strukturiertes Adressobjekt für den Wohnsitz. 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 demselben Endbenutzer zuzuordnen und Fehlalarme bei der Duplikatserkennung zu reduzieren.Beispiel: user-1234

Regeln für Eingaben 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 senden.
  • Senden Sie für Adressdienste 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 die Angabe zu Wohnung, Einheit, Gebäude oder Etage bzw. eine zusätzliche Adresszeile. Senden Sie das Feld nur, wenn Sie die Angabe haben.
  • address.city ist Stadt, Vorort, Distrikt, 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 rufen Sie den Dienst auf

Zurückgegebene Daten

Welche Felder in source_data angezeigt werden, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für phl_residential dokumentiert derzeit folgende normalisierte Struktur:
  • date_of_birth
  • name_match_score

Preise & SLAs

Abfragen für Wohnadressen auf den Philippinen werden nur abgerechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Abfrage: $0.59 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Sie werden nicht belastet, 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