curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_vehicle_ownership" \
-F "vendor_data=user-1234" \
-F "national_id=SAMPLE-NID-12345" \
-F "vehicle_register_number=VRN123456" \
-F "vehicle_licence_plate=ABC123GP" \
-F "vin=1HGCM82633A004352"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇿🇦 南アフリカ
南アフリカ 車両所有者確認API
Diditで南アフリカの公的データベースを照会し、車両所有者を確認できます。1回の呼び出しあたり$3.36からの従量課金で、契約や最低利用額は不要です。
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_vehicle_ownership" \
-F "vendor_data=user-1234" \
-F "national_id=SAMPLE-NID-12345" \
-F "vehicle_register_number=VRN123456" \
-F "vehicle_licence_plate=ABC123GP" \
-F "vin=1HGCM82633A004352"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
NATIS車両登録簿を通じて、南アフリカの個人が特定の車両の登録所有者であることを確認します。Didit はこのサービスを
POST /v3/database-validation/で提供しているため、送信されたデータを公式の情報源と照合し、正規化された照合結果を受け取ることができます。
対応範囲
- 対応範囲: -
- 国: 南アフリカ
- サービスID:
zaf_vehicle_ownership - データ領域: 政府
- カテゴリ: その他
入力
| フィールド | 必須 | 例 |
|---|---|---|
national_id | はい | SAMPLE-NID-12345 |
vehicle_register_number | はい | VRN123456 |
vehicle_licence_plate | はい | ABC123GP |
vin | はい | 1HGCM82633A004352 |
vendor_data | いいえ | user-1234 |
- 必須の入力:
national_id、vehicle_register_number、vehicle_licence_plate、vin - 任意の入力:
vendor_data - 同意: 不要
- ワークフローでの利用: フィールドマッピングによりワークフローで利用可能
- 対応範囲: -
- 料金: 成功したクエリ1件あたり$3.36
vehicle_register_number、vehicle_licence_plate、vinは本人確認書類に記載されていないため、これらを単独で取得するステップはありません。アンケートの回答、Document AIの抽出フィールド、またはセッション作成時に送信する値から取得し、データベース検証ステップでそれぞれをマッピングしてください。マッピングが完了するまで、ワークフローエディターではこのサービスが無効と表示され、不足している入力の名前が示されます。実行時に入力が不足している場合は、クエリを行う前にチェックがスキップされるため、問い合わせできなかったデータベースについて請求されることはありません。
ボディパラメーター
string
デフォルト:"ZAF"
必須
このデータベースサービスのISO 3166-1 alpha-3国コードです。例:
ZAFstring
デフォルト:"zaf_vehicle_ownership"
必須
このサービスIDを含む配列です。サービスを固定することで、リクエストの対象をこのデータベースに限定できます。例:
zaf_vehicle_ownershipstring
デフォルト:"SAMPLE-NID-12345"
必須
このサービスで使用する国民識別番号です。例:
SAMPLE-NID-12345string
デフォルト:"VRN123456"
必須
このデータベースサービスで必須の
vehicle_register_numberの値です。例:VRN123456string
デフォルト:"ABC123GP"
必須
このデータベースサービスで必須の
vehicle_licence_plateの値です。例:ABC123GPstring
デフォルト:"1HGCM82633A004352"
必須
このデータベースサービスで必須の
vinの値です。例:1HGCM82633A004352string
デフォルト:"user-1234"
社内のユーザーIDなど、この人物を示す固定のユーザー参照値です。Didit はこれを使用して、単独で実行したチェックを同じエンドユーザーに紐付け、重複検出のノイズを減らします。例:
user-1234入力ルールと検証に関する注意事項
- 上記のフィールドは、ユーザーまたは書類から取得したとおりに正確に送信してください。
- Didit はデータベースに照会する前に必須フィールドを検証します。情報源への照会前に拒否されたリクエストは課金されません。
呼び出し方法
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_vehicle_ownership" \
-F "vendor_data=user-1234" \
-F "national_id=SAMPLE-NID-12345" \
-F "vehicle_register_number=VRN123456" \
-F "vehicle_licence_plate=ABC123GP" \
-F "vin=1HGCM82633A004352"
呼び出しが成功すると、常にHTTP 200が返されます。outcome_codeフィールドは実際に何が起きたかを示し、たとえば実際の生体情報の不一致(BIOMETRIC_NO_MATCH)と、読み取れなかったセルフィー(BIOMETRIC_IMAGE_UNUSABLE)を区別できます。表示されるstatusはデフォルトの機能ステータスであり、設定済みの部分一致/不一致時のアクションによって上書きされる場合があります。MATCH:登録簿が本人であることを確認し、チェックしたすべてのフィールドが一致しました。{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
NO_MATCH:送信されたデータに一致するものが登録簿にありませんでした。{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
返されるデータ
source_dataに含まれる具体的なフィールドは、登録簿が返す内容によって異なります。zaf_vehicle_ownershipの生成例では、現在次の正規化された形式が記載されています。
identification_number
料金とSLA
南アフリカ - 車両所有権確認のクエリは、Didit が検証元から確定的な結果を受け取った場合にのみ課金されます。- 呼び出し1回あたりの料金: $3.36 USD。
- 請求: 成功したクエリ1件あたり。登録簿に接続できない場合、必須フィールドが不足している場合、またはリクエストが情報源に届く前に拒否された場合は課金されません。
- レイテンシー: 通常、p95は2秒未満。
- 可用性: Didit側で四半期あたり99.9%。下流の情報源の可用性は国やデータセットによって異なります。
関連情報
最終更新日 2026年11月1日