Zum Hauptinhalt springen
POST
Aggregierter Dienst mit Behörden- und öffentlichen Registern, Hintergrunddaten und weiteren Diensten. 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: ~ 85%
  • Land: Vereinigte Staaten
  • Dienst-ID: usa_states_financial_services
  • Datenbereich: Finanzen
  • Kategorie: FinancialServices

Eingaben

  • Pflichtfelder: first_name, last_name, date_of_birth
  • Optionale Felder: address.street_1, address.street_2, address.city, address.region, address.postal_code, phone, ssn, email, vendor_data
  • Einwilligung: Nicht erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~ 85%
  • Preis: $0.20 pro erfolgreicher Abfrage

Body-Parameter

string
Standard:"USA"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: USA
string
Standard:"usa_states_financial_services"
erforderlich
Array, das diese Dienst-ID enthält. Das Festlegen des Dienstes begrenzt die Anfrage auf genau diese Datenbank.Beispiel: usa_states_financial_services
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
object
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, 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
Telefonnummer im internationalen Format.Beispiel: +15550101000
string
ssn-Wert, der von diesem Datenbankdienst benötigt wird.Beispiel: 123456789
string
E-Mail-Adresse.Beispiel: john.doe@example.com
string
Standard:"user-1234"
Ihre dauerhafte Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen mit demselben Endbenutzer zu verknüpfen und Störsignale bei der Duplikaterkennung zu reduzieren.Beispiel: user-1234

Eingaberegeln und Validierungshinweise

  • address ist für diesen Dienst optional. Sie können eine vollständige address-Zeichenfolge senden, und Didit zerlegt sie nach Möglichkeit in strukturierte Adressbestandteile. Alternativ können Sie die strukturierten Felder explizit übermitteln.
  • US-Sozialversicherungsnummer oder ITIN - vollständig mit 9 Ziffern (Bindestriche optional) oder nur die letzten 4 Ziffern
  • ssn muss dem Muster (?:\d{9}|\d{3}-\d{2}-\d{4}|\d{4}) entsprechen.
  • Senden Sie für ssn entweder die vollständige 9-stellige SSN/ITIN (Bindestriche optional) oder nur deren letzte 4 Ziffern.
  • Dieser Dienst benötigt first_name, last_name und date_of_birth. Damit ist das Minimum der Quelle erfüllt, nämlich ein Name und ein weiteres Identitätsmerkmal. Optionale Felder (ssn, address, phone, email) stärken die Übereinstimmung zusätzlich.
  • Senden Sie für adressbasierte Dienste 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 ist Wohnung, Einheit, Gebäude, Etage oder eine zusätzliche Adresszeile. Senden Sie dieses Feld nur, wenn Sie den Wert haben.
  • 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 benötigen mindestens Straßenadresse und Postleitzahl. Anfragen, die vor der Quellenabfrage abgelehnt werden, werden nicht berechnet.

So rufen Sie es auf

Zurückgegebene Daten

Welche Felder in source_data ausgegeben werden, hängt davon ab, was das Register zurückliefert. Das generierte Beispiel für usa_states_financial_services dokumentiert derzeit diese normalisierte Struktur:
  • address
  • address_match_score
  • city
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score
  • postal_code
  • state
  • street

Preise & SLAs

Abfragen für United States of America – United States Financial Services werden nur abgerechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Abfrage: $0.20 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischer p95 < 2 s.
  • Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit. Die Verfügbarkeit der nachgelagerten Quellen variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026