curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cnh_facial_qrcode" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg" \
-F "cnh_qr_code_image=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"cnh_qrcode": "sample_value",
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇧🇷 ブラジル
ブラジル CNH QRコード+顔照合(Datavalid)API
Diditでブラジルの運転免許証(CNH)のQRコードと顔照合を、Datavalidの公的データベースで検証できます。1回$0.62からの従量課金で、契約や最低利用額はありません。
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cnh_facial_qrcode" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg" \
-F "cnh_qr_code_image=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"cnh_qrcode": "sample_value",
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
SERPRO Datavalid v4 pf-facial-qrcodeは、ブラジルのCNH運転免許証(物理カードまたはデジタル形式で、2017年5月以降に発行されたもの)に印刷されたQRコードを読み取り、CPF、氏名、生年月日をReceita Federalのデータと照合したうえで、ライブで撮影したセルフィーをSenatranに保存されているCNHの顔写真と照合します。Diditはこのサービスを
POST /v3/database-validation/で提供しているため、送信されたデータを公式の情報源と照合し、正規化された照合結果を受け取ることができます。
対象範囲
- 対象範囲: -
- 国: ブラジル
- サービスID:
bra_cnh_facial_qrcode - データ領域: 生体情報
- カテゴリ: DriverLicence
入力
| フィールド | 必須 | 例 |
|---|---|---|
tax_number | はい | 11111111111 |
selfie | はい | @./selfie.jpg |
cnh_qr_code_image | はい | data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB |
first_name | いいえ | John |
last_name | いいえ | Doe |
date_of_birth | いいえ | 1990-01-01 |
vendor_data | いいえ | user-1234 |
- 必須の入力:
tax_number、selfie、cnh_qr_code_image - 任意の入力:
first_name、last_name、date_of_birth、vendor_data - 同意: 必須
- ワークフローの利用可否: 利用可能
- 対象範囲: -
- 料金: 成功したクエリ1件あたり$0.62
ボディパラメーター
string
デフォルト:"BRA"
必須
このデータベースサービスのISO 3166-1 alpha-3国コードです。例:
BRAstring
デフォルト:"bra_cnh_facial_qrcode"
必須
このサービスIDを含む配列です。サービスを固定することで、リクエストの対象をこのデータベースのみに限定できます。例:
bra_cnh_facial_qrcodeboolean
デフォルト:"true"
必須
このサービスに対するエンドユーザーの明示的な同意です。例:
truestring
デフォルト:"11111111111"
必須
税務上の識別番号(納税者番号)です。例:
11111111111file
必須
生体認証データベースでの検証のためにアップロードするセルフィー画像ファイルです。対応形式はJPEG、PNG、WebPです。例:
@./selfie.jpgstring
必須
このデータベースサービスで必須となる
cnh_qr_code_imageの値です。例:data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABstring
検証する名(ファーストネーム)です。例:
Johnstring
検証する姓(ラストネーム)です。例:
Doestring
YYYY-MM-DD形式の生年月日です。例:1990-01-01string
デフォルト:"user-1234"
内部ユーザーIDなど、この人物を識別するための固定のユーザー参照値です。Diditはこの値を使って単独で実行したチェックを同一のエンドユーザーに紐付け、重複検出のノイズを減らします。例:
user-1234入力ルールと検証に関する注意事項
- ブラジルのCPF(ちょうど11桁)
tax_numberには数字のみを含める必要があります。リクエストを送信する前に、スペース、ハイフン、句読点を取り除いてください。tax_numberはちょうど11文字である必要があります。
呼び出し方法
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cnh_facial_qrcode" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg" \
-F "cnh_qr_code_image=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
呼び出しが成功すると、常にHTTP
200が返されます。実際に何が起きたかはoutcome_codeフィールドで確認できます。たとえば、生体情報が実際に一致しなかった場合(BIOMETRIC_NO_MATCH)と、セルフィーを読み取れなかった場合(BIOMETRIC_IMAGE_UNUSABLE)を区別できます。表示されるstatusは機能のデフォルトのステータスであり、設定した部分一致/不一致時のアクションによって上書きされる場合があります。MATCH:登録機関が本人であることを確認し、チェックしたすべてのフィールドが一致しました。{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"cnh_qrcode": "sample_value",
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
NO_MATCH:登録機関から、送信されたデータに一致する結果が返されませんでした。{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
BIOMETRIC_NO_MATCH:顔照合スコアが一致判定のしきい値を下回りました。セルフィーの人物は登録機関の写真の人物と同一ではありません。{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
BIOMETRIC_IMAGE_UNUSABLE:セルフィーを処理できませんでした(画像が空、顔が写っていない、品質が低い、または登録機関が読み取れなかった)。ユーザーにセルフィーの撮り直しを促してください。{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
返されるデータ
source_dataに含まれる具体的なフィールドは、登録機関が返す内容によって異なります。bra_cnh_facial_qrcodeの生成サンプルでは、現在次の正規化された形式が記載されています。
cnh_qrcodedate_of_birthface_match_probabilityface_match_scorefirst_nameidentification_numberlast_namename_match_score
料金とSLA
ブラジルのCNH QRコード+顔照合(Datavalid)のクエリは、Diditが検証元から確定的な結果を受け取った場合にのみ課金されます。- 1回あたりの料金: $0.62 USD。
- 請求: 成功したクエリごとに課金されます。登録機関に接続できない場合、必須フィールドが欠けている場合、またはリクエストが検証元に届く前に拒否された場合は課金されません。
- レイテンシ: 通常、p95で2秒未満。
- 可用性: Didit側で四半期あたり99.9%。下流の検証元の可用性は国やデータセットによって異なります。
関連情報
最終更新日 2026年11月1日