curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZMB" \
-F "services=zmb_national_id" \
-F "vendor_data=user-1234" \
-F "national_id=123456/78/9" \
-F "first_name=John" \
-F "last_name=Doe"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="ZMB",
services=["zmb_national_id"],
first_name="John",
last_name="Doe",
national_id="123456/78/9",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "ZMB",
Services: didit.Some([]string{"zmb_national_id"}),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
NationalID: didit.String("123456/78/9"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("ZMB")
.services(List.of("zmb_national_id"))
.firstName("John")
.lastName("Doe")
.nationalId("123456/78/9")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'ZMB',
'services' => ['zmb_national_id'],
'first_name' => 'John',
'last_name' => 'Doe',
'national_id' => '123456/78/9',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234"
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "ZMB",
Services = new string[] { "zmb_national_id" },
FirstName = "John",
LastName = "Doe",
NationalId = "123456/78/9",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZMB",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "ZMB",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
Datenbankvalidierung
Datenbankvalidierung Sambia NRC (Steuerregister) API
Sambia NRC (Steuerregister): autoritative Datenbankvalidierung über Didit. Ab $0.20 pro Abruf, ohne Verträge und Mindestabnahme.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZMB" \
-F "services=zmb_national_id" \
-F "vendor_data=user-1234" \
-F "national_id=123456/78/9" \
-F "first_name=John" \
-F "last_name=Doe"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="ZMB",
services=["zmb_national_id"],
first_name="John",
last_name="Doe",
national_id="123456/78/9",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "ZMB",
Services: didit.Some([]string{"zmb_national_id"}),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
NationalID: didit.String("123456/78/9"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("ZMB")
.services(List.of("zmb_national_id"))
.firstName("John")
.lastName("Doe")
.nationalId("123456/78/9")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'ZMB',
'services' => ['zmb_national_id'],
'first_name' => 'John',
'last_name' => 'Doe',
'national_id' => '123456/78/9',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234"
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "ZMB",
Services = new string[] { "zmb_national_id" },
FirstName = "John",
LastName = "Doe",
NationalId = "123456/78/9",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZMB",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "ZMB",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
Prüft, ob eine Nummer der sambischen National Registration Card (NRC) zu dem genannten Steuerpflichtigen im Register der Zambia Revenue Authority gehört. Das Register enthält nur den vollständigen Namen des Steuerpflichtigen, daher ist der Name das einzige Feld, das verglichen wird. Didit stellt diesen Dienst über
POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Abgleichsergebnisse erhalten.
Abdeckung
- Abdeckung: —
- Land: Sambia
- Service-ID:
zmb_national_id - Datenbereich: Identität
- Kategorie: TaxRegistry
Eingaben
| Feld | Erforderlich | Beispiel |
|---|---|---|
national_id | Ja | 123456/78/9 |
first_name | Ja | John |
last_name | Ja | Doe |
vendor_data | Nein | user-1234 |
- Pflichteingaben:
national_id,first_name,last_name - Optionale Eingaben:
vendor_data - Einwilligung: Nicht erforderlich
- Verfügbarkeit im Workflow: Im Workflow verfügbar
- Abdeckung: —
- Preis: $0.20 pro erfolgreiche Abfrage
Body-Parameter
string
Standard:"ZMB"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel:
ZMBstring
Standard:"zmb_national_id"
erforderlich
Array mit der ID dieses Dienstes. Das Festlegen des Dienstes beschränkt die Anfrage auf genau diese Datenbank.Beispiel:
zmb_national_idstring
Standard:"123456/78/9"
erforderlich
Nationale Identitätsnummer für diesen Dienst.Beispiel:
123456/78/9string
Standard:"John"
erforderlich
Zu validierender Vorname.Beispiel:
Johnstring
Standard:"Doe"
erforderlich
Zu validierender Nachname.Beispiel:
Doestring
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und das Rauschen bei der Dublettenerkennung zu verringern.Beispiel:
user-1234Eingaberegeln und Validierungshinweise
national_idmuss Großbuchstaben verwenden.national_idmuss\d{6}/?\d{2}/?\dentsprechen.
So rufen Sie es auf
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZMB" \
-F "services=zmb_national_id" \
-F "vendor_data=user-1234" \
-F "national_id=123456/78/9" \
-F "first_name=John" \
-F "last_name=Doe"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="ZMB",
services=["zmb_national_id"],
first_name="John",
last_name="Doe",
national_id="123456/78/9",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "ZMB",
Services: didit.Some([]string{"zmb_national_id"}),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
NationalID: didit.String("123456/78/9"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("ZMB")
.services(List.of("zmb_national_id"))
.firstName("John")
.lastName("Doe")
.nationalId("123456/78/9")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'ZMB',
'services' => ['zmb_national_id'],
'first_name' => 'John',
'last_name' => 'Doe',
'national_id' => '123456/78/9',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234"
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "ZMB",
Services = new string[] { "zmb_national_id" },
FirstName = "John",
LastName = "Doe",
NationalId = "123456/78/9",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
Jeder erfolgreiche Aufruf gibt HTTP 200 zurück. Das Feld outcome_code zeigt Ihnen, was tatsächlich passiert ist. So unterscheidet es beispielsweise eine echte biometrische Nichtübereinstimmung (BIOMETRIC_NO_MATCH) von einem Selfie, das nicht gelesen werden konnte (BIOMETRIC_IMAGE_UNUSABLE). Der angezeigte status ist der Standardstatus der Funktion; Ihre konfigurierten Aktionen bei Teilübereinstimmung / keinem Treffer können ihn überschreiben.MATCH: Das Register hat die Identität bestätigt, und alle geprüften Felder stimmten überein.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZMB",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
PARTIAL_MATCH: Die Identifikationsnummer wurde gefunden, aber ein oder mehrere persönliche Felder (meist Name oder Geburtsdatum) stimmten nicht vollständig überein.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "ZMB",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
NO_MATCH: Das Register hat für die übermittelten Daten keinen Treffer zurückgegeben.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
DOCUMENT_NOT_FOUND: Die übermittelte Dokumentnummer entspricht keinem Datensatz im Register.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
Zurückgegebene Daten
Welche genauen Felder insource_data ausgegeben werden, hängt davon ab, was das Register zurückgibt. Die generierte Beispielantwort für zmb_national_id dokumentiert derzeit diese normalisierte Struktur:
first_namefull_nameidentification_numberlast_nameregistration_status
Preise und SLAs
Abfragen des sambischen NRC (Steuerregister) werden nur abgerechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.- Preis pro Aufruf: $0.20 USD.
- Abrechnung: pro erfolgreiche Abfrage. Ihnen werden keine Kosten 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