Zum Hauptinhalt springen
POST
Prüft Eingabedaten anhand des Dienstes für die Personenstandsregistrierung. 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: ~ 100%
  • Land: Dänemark
  • Service-ID: dnk_national_id
  • Datenbereich: Identität
  • Kategorie: NationalIDRegistry

Eingaben

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

Body-Parameter

string
Standard:"DNK"
erforderlich
ISO-3166-1-Ländercode mit drei Buchstaben (alpha-3) für diesen Datenbankdienst.Beispiel: DNK
string
Standard:"dnk_national_id"
erforderlich
Array mit dieser Service-ID. Die Angabe des Dienstes beschränkt die Anfrage auf genau diese Datenbank.Beispiel: dnk_national_id
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
string
Standard:"0101901234"
erforderlich
Personenkennzahl für diesen Dienst.Beispiel: 0101901234
object
Strukturiertes Objekt für die Wohnadresse. Verwenden Sie street_1, street_2, city, region, postal_code und country. Eine vollständige 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, zum Beispiel Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und Störungen durch die Erkennung von Duplikaten zu reduzieren.Beispiel: user-1234

Eingaberegeln und Hinweise zur Validierung

  • address ist für diesen Dienst optional. Sie können eine vollständige address-Zeichenkette übermitteln, und Didit zerlegt sie nach Möglichkeit in strukturierte Adressbestandteile. Alternativ können Sie die strukturierten Felder explizit übermitteln.
  • national_id muss dem Muster \d{6}-?\d{4} entsprechen.
  • Verwenden 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 Wohnung, Einheit, Gebäude, Etage oder eine zusätzliche Adresszeile. Übermitteln Sie sie nur, wenn Sie sie haben.
  • address.city ist Stadt, Stadtteil, Bezirk, Ortschaft oder Viertel.
  • address.region ist Bundesland, Provinz, Region oder Ortschaft.
  • 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.

Aufruf

Zurückgegebene Daten

Welche Felder genau in source_data enthalten sind, hängt von den Daten ab, die das Register zurückgibt. Das generierte Beispiel für dnk_national_id dokumentiert derzeit folgende normalisierte Struktur:
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score

Preise & SLAs

Abfragen der dänischen Personenkennzahl werden nur berechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Aufruf: $2.32 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: typischerweise p95 < 2 s.
  • Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit; die Verfügbarkeit nachgelagerter Quellen variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026