Zum Hauptinhalt springen
POST
Überprüft Name, Geburtsdatum und Adresse eines Inhabers eines spanischen DNI oder NIE anhand der nationalen Ausweisregister. 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 können.

Abdeckung

  • Abdeckung: ~ 75%
  • Land: Spanien
  • Service-ID: esp_dni
  • Datenbereich: Identität
  • Kategorie: NationalIDRegistry

Eingaben

  • Pflichteingaben: first_name, last_name, date_of_birth, address.street_1, address.postal_code
  • Optionale Eingaben: national_id, phone, address.street_2, address.city, address.region, vendor_data
  • Einwilligung: Erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~ 75%
  • Preis: $2.10 pro erfolgreicher Abfrage

Body-Parameter

string
Standard:"ESP"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbank-Service.Beispiel: ESP
string
Standard:"esp_dni"
erforderlich
Array mit dieser Service-ID. Durch die Festlegung des Services bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: esp_dni
Ausdrückliche Einwilligung des Endbenutzers für diesen Service.Beispiel: true
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
erforderlich
Strukturiertes Objekt für die Wohnadresse. Verwenden Sie street_1, street_2, city, region, postal_code und country. Eine vollständige Adresszeichenkette 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
Nationale Identitätsnummer für diesen Service.Beispiel: SAMPLE-NID-12345
string
Telefonnummer im internationalen Format.Beispiel: +15550101000
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 der Dubletten-Erkennung zu verringern.Beispiel: user-1234

Eingaberegeln und Validierungshinweise

  • Für Adress-Services senden Sie 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 bezeichnet eine Wohnung, Einheit, ein Gebäude, ein Stockwerk oder eine zusätzliche Adresszeile. Senden Sie sie nur, wenn Sie diese Angabe haben.
  • address.city ist Stadt, Stadtteil, Bezirk, Ortschaft oder Viertel.
  • address.region ist Bundesland, Provinz, Region oder Stadt.
  • address.postal_code ist die Postleitzahl.
  • Adressbasierte Datenbank-Services erfordern 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 genau in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für esp_dni dokumentiert derzeit diese normalisierte Struktur:
  • address_match_score
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score

Preise & SLAs

Spanien - DNI/NIE-Verifizierungen werden nur dann berechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Abfrage: $2.10 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: typisch p95 unter 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