Zum Hauptinhalt springen
POST
Prüft Eingabedaten gegen den Dienst der schwedischen Polizeibehörde. 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: Schweden
  • Dienst-ID: swe_national_id
  • Datenbereich: Identität
  • Kategorie: NationalIDRegistry

Eingaben

  • Erforderliche Eingaben: 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: $0.59 pro erfolgreiche Abfrage
Nicht jedes Dokument, das dieser Dienst akzeptiert, enthält den Identifikator, über den abgefragt wird. Wenn der Identifikator nicht aus dem Dokument extrahiert wird, wird die Prüfung als nicht zutreffend erfasst - es wird keine Datenbank abgefragt und Ihnen wird nichts berechnet. Für einige Länder betrifft dies einen großen Anteil realer Nutzer. Um diese Fälle abzudecken, erfassen Sie den Identifikator zusätzlich über eine Antwort aus einem Fragebogen, ein Extraktionsfeld von Document AI oder einen Wert, den Sie beim Erstellen der Sitzung übermitteln, und ordnen Sie ihn dem Schritt Datenbankvalidierung zu.

Body-Parameter

string
Standard:"SWE"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: SWE
string
Standard:"swe_national_id"
erforderlich
Array, das diese Dienst-ID enthält. Das Festlegen des Dienstes beschränkt die Anfrage auf genau diese Datenbank.Beispiel: swe_national_id
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
string
Standard:"199001011234"
erforderlich
Nationale Personenkennziffer für diesen Dienst.Beispiel: 199001011234
object
Strukturiertes Objekt für die Wohnadresse. Verwenden Sie street_1, street_2, city, region, postal_code und country. Eine vollständige Adresszeichenfolge im Altformat 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 demselben Endbenutzer zuzuordnen und Rauschen bei der Duplikaterkennung zu verringern.Beispiel: user-1234

Eingaberegeln und Validierungshinweise

  • address ist für diesen Dienst optional. Sie können eine vollständige address-Zeichenfolge übermitteln, und Didit zerlegt sie nach Möglichkeit in strukturierte Adressbestandteile. Alternativ können Sie die strukturierten Felder explizit übermitteln.
  • national_id darf nur Ziffern enthalten. Entfernen Sie Leerzeichen, Bindestriche und Satzzeichen, bevor Sie die Anfrage senden.
  • national_id muss dem Muster (\d{10}|\d{12}) entsprechen.
  • Verwenden Sie bei Adressdiensten 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. Übermitteln Sie sie nur, wenn Sie sie 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 Datenbankdienste erfordern mindestens Straßenadresse und Postleitzahl. Anfragen, die vor der Abfrage der Quelle abgelehnt werden, werden nicht berechnet.

So wird die Funktion aufgerufen

Zurückgegebene Daten

Welche Felder genau in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für swe_national_id dokumentiert derzeit diese normalisierte Struktur:
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score

Preise & SLAs

Abfragen von Sweden National ID werden nur abgerechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Aufruf: $0.59 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-Wert < 2 s.
  • Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit. Die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026