Zum Hauptinhalt springen
POST
Verifiziert Daten zum eindeutigen guatemaltekischen Identifikationscode gegen die amtlichen Register der SAT. 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: document_number erwartet den guatemaltekischen DPI (genau 13 Ziffern).

Abdeckung

  • Abdeckung: 90-95%
  • Land: Guatemala
  • Dienst-ID: gtm_dpi
  • Datenbereich: Identität
  • Kategorie: NationalIDRegistry

Eingaben

  • Pflicht-Eingaben: document_number, date_of_birth
  • Optionale Eingaben: first_name, last_name, vendor_data
  • Einwilligung: Nicht erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: 90-95%
  • Preis: $0.20 pro erfolgreicher Abfrage

Body-Parameter

string
Standard:"GTM"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: GTM
string
Standard:"gtm_dpi"
erforderlich
Array mit dieser Dienst-ID. Durch das Festlegen des Dienstes bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: gtm_dpi
string
Standard:"1111111111111"
erforderlich
Dokumentnummer, die aus einem Dokument extrahiert oder vom Benutzer bereitgestellt wurde.Beispiel: 1111111111111
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Zu validierender Vorname.Beispiel: John
string
Zu validierender Nachname.Beispiel: Doe
string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, z. B. Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und Fehlalarme bei der Duplikaterkennung zu verringern.Beispiel: user-1234

Eingaberegeln und Hinweise zur Validierung

  • Guatemaltekischer DPI (genau 13 Ziffern)
  • document_number darf nur Ziffern enthalten; entfernen Sie vor dem Senden der Anfrage Leerzeichen, Bindestriche und Satzzeichen.
  • document_number muss genau 13 Zeichen lang sein.

So rufen Sie den Dienst 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 gtm_dpi dokumentiert derzeit diese normalisierte Struktur:
  • first_name
  • full_name
  • identification_number
  • last_name

Preise und SLAs

Guatemala - DPI-Verifizierungsabfragen werden nur berechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Aufruf: $0.20 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Sie zahlen nichts, 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 Quelle variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026