Zum Hauptinhalt springen
POST
Prüft anhand einer kombinierten Datenbank der Wählerregistrierungen. 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. Eingabeformat: tax_number nimmt die brasilianische CPF entgegen (genau 11 Ziffern).

Abdeckung

  • Abdeckung: ~ 95%
  • Land: Brasilien
  • Service-ID: bra_residential
  • Datenbereich: Adresse
  • Kategorie: Wohnsitz

Eingaben

  • Pflichteingaben: first_name, last_name, date_of_birth, address.street_1, address.postal_code, tax_number
  • Optionale Eingaben: address.street_2, address.city, address.region, vendor_data
  • Einwilligung: nicht erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~ 95%
  • Preis: $0.59 pro erfolgreicher Abfrage
Nicht jedes Dokument, das dieser Dienst akzeptiert, enthält die Kennung, über die abgefragt wird. Wenn die Kennung nicht aus dem Dokument extrahiert wird, wird die Prüfung als nicht zutreffend erfasst: Es wird keine Datenbank abgefragt, und Ihnen wird nichts berechnet. Bei manchen Ländern betrifft das einen großen Teil der tatsächlichen Nutzer. Um sie abzudecken, erfassen Sie die Kennung zusätzlich über eine Fragebogen-Antwort, ein Document-AI-Extraktionsfeld oder einen Wert, den Sie beim Erstellen der Sitzung übermitteln, und ordnen Sie sie im Schritt „Datenbankvalidierung“ zu.

Body-Parameter

string
Standard:"BRA"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: BRA
string
Standard:"bra_residential"
erforderlich
Array, das diese Service-ID enthält. Durch das Festlegen des Dienstes bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: bra_residential
string
Standard:"John"
erforderlich
Vorname, der validiert werden soll.Beispiel: John
string
Standard:"Doe"
erforderlich
Nachname, der validiert werden soll.Beispiel: Doe
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
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, 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:"11111111111"
erforderlich
Steuer- oder Identifikationsnummer.Beispiel: 11111111111
string
Standard:"user-1234"
Ihre stabile 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 das Rauschen bei Dublettenerkennung zu verringern.Beispiel: user-1234

Regeln für Eingaben und Validierungshinweise

  • Brasilianische CPF (genau 11 Ziffern)
  • tax_number darf nur Ziffern enthalten; entfernen Sie vor dem Senden der Anfrage Leerzeichen, Bindestriche und Satzzeichen.
  • tax_number muss genau 11 Zeichen lang sein.
  • Bei Adressdiensten senden Sie nach Möglichkeit strukturierte Adressfelder statt eines einzelnen address-Strings.
  • address.street_1 ist die Straßenadresse einschließlich Hausnummer und Straßentyp.
  • address.street_2 enthält die Wohnungs-, Einheiten-, Gebäude- oder Etagenbezeichnung bzw. eine zusätzliche Adresszeile. Senden Sie es nur, wenn Sie es 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.

Aufruf

Zurückgegebene Daten

Welche Felder genau in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Die generierte Beispielantwort für bra_residential dokumentiert derzeit diese normalisierte Struktur:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

Preise und SLAs

Abfragen von Brazil Residential werden nur dann abgerechnet, wenn Didit von der Validierungsquelle ein schlüssiges Ergebnis erhält.
  • Preis pro Abfrage: $0.59 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, wenn erforderliche Felder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischer p95-Wert < 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