Zum Hauptinhalt springen
POST
Prüft Eingabedaten gegen die offizielle ausstellende Behörde des finnischen Personalausweises. Didit stellt diesen Service über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten gegen die maßgebliche Quelle prüfen und normalisierte Übereinstimmungsergebnisse erhalten.

Abdeckung

  • Abdeckung: ~ 100%
  • Land: Finnland
  • Service-ID: fin_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: Erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~ 100%
  • Preis: $3.50 pro erfolgreiche Abfrage
Nicht jedes Dokument, das dieser Service akzeptiert, enthält den Identifikator, über den abgefragt wird. Wird der Identifikator nicht aus dem Dokument extrahiert, 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 realen Nutzer. Um auch diese Nutzer abzudecken, erfassen Sie den Identifikator zusätzlich über eine Antwort aus einem Fragebogen, ein Document-AI-Extraktionsfeld oder einen Wert, den Sie beim Erstellen der Sitzung senden, und ordnen ihn im Schritt zur Datenbankvalidierung zu.

Body-Parameter

string
Standard:"FIN"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankservice.Beispiel: FIN
string
Standard:"fin_national_id"
erforderlich
Array mit der ID dieses Service. Das Festlegen des Service hält die Anfrage auf genau diese Datenbank beschränkt.Beispiel: fin_national_id
Ausdrückliche Einwilligung des Endbenutzers für diesen Service.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
string
Standard:"010190-123A"
erforderlich
Personenidentifikationsnummer für diesen Service.Beispiel: 010190-123A
object
Strukturiertes Objekt für die Wohnadresse. Verwenden Sie street_1, street_2, city, region, postal_code und country. Ein vollständiger Adressstring 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:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit nutzt sie, um eigenständige Prüfungen derselben Endbenutzer zuzuordnen und das Rauschen bei der Erkennung von Duplikaten zu reduzieren.Beispiel: user-1234

Eingaberegeln und Hinweise zur Validierung

  • address ist für diesen Service optional. Sie können einen vollständigen address-String senden, den Didit nach Möglichkeit in strukturierte Adressbestandteile aufteilt, oder Sie senden die strukturierten Felder explizit.
  • national_id muss dem Muster (?:\d{6}[-+A]\d{3}[0-9A-Z]|\d{6}\d{3}[0-9A-Z]) entsprechen.
  • Bei Adress-Services 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 ist Wohnung, Einheit, Gebäude, Etage oder eine zusätzliche Adresszeile. Senden Sie es nur, wenn Sie diese Angabe haben.
  • address.city ist Stadt, Vorort, Bezirk, Ortschaft oder Viertel.
  • address.region ist Bundesland, Provinz, Region oder Ort.
  • address.postal_code ist die Postleitzahl.
  • Adressbasierte Datenbankservices erfordern mindestens eine Straßenadresse und eine 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 fin_national_id dokumentiert derzeit diese normalisierte Struktur:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

Preise & SLAs

Abfragen der finnischen nationalen ID werden nur berechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Aufruf: $3.50 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: typischerweise 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