メインコンテンツへスキップ
POST
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、selfie、cnh_qr_code_image
  • 任意の入力: first_name、last_name、date_of_birth、vendor_data
  • 同意: 必須
  • ワークフローの利用可否: 利用可能
  • 対象範囲: -
  • 料金: 成功したクエリ1件あたり$0.62

ボディパラメーター

string
デフォルト:"BRA"
必須
このデータベースサービスのISO 3166-1 alpha-3国コードです。例:BRA
string
デフォルト:"bra_cnh_facial_qrcode"
必須
このサービスIDを含む配列です。サービスを固定することで、リクエストの対象をこのデータベースのみに限定できます。例:bra_cnh_facial_qrcode
このサービスに対するエンドユーザーの明示的な同意です。例:true
string
デフォルト:"11111111111"
必須
税務上の識別番号(納税者番号)です。例:11111111111
file
必須
生体認証データベースでの検証のためにアップロードするセルフィー画像ファイルです。対応形式はJPEG、PNG、WebPです。例:@./selfie.jpg
string
必須
このデータベースサービスで必須となるcnh_qr_code_imageの値です。例:data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB
string
検証する名(ファーストネーム)です。例:John
string
検証する姓(ラストネーム)です。例:Doe
string
YYYY-MM-DD形式の生年月日です。例:1990-01-01
string
デフォルト:"user-1234"
内部ユーザーIDなど、この人物を識別するための固定のユーザー参照値です。Diditはこの値を使って単独で実行したチェックを同一のエンドユーザーに紐付け、重複検出のノイズを減らします。例:user-1234

入力ルールと検証に関する注意事項

  • ブラジルのCPF(ちょうど11桁)
  • tax_numberには数字のみを含める必要があります。リクエストを送信する前に、スペース、ハイフン、句読点を取り除いてください。
  • tax_numberはちょうど11文字である必要があります。

呼び出し方法

返されるデータ

source_dataに含まれる具体的なフィールドは、登録機関が返す内容によって異なります。bra_cnh_facial_qrcodeの生成サンプルでは、現在次の正規化された形式が記載されています。
  • cnh_qrcode
  • date_of_birth
  • face_match_probability
  • face_match_score
  • first_name
  • identification_number
  • last_name
  • name_match_score

料金とSLA

ブラジルのCNH QRコード+顔照合(Datavalid)のクエリは、Diditが検証元から確定的な結果を受け取った場合にのみ課金されます。
  • 1回あたりの料金: $0.62 USD。
  • 請求: 成功したクエリごとに課金されます。登録機関に接続できない場合、必須フィールドが欠けている場合、またはリクエストが検証元に届く前に拒否された場合は課金されません。
  • レイテンシ: 通常、p95で2秒未満。
  • 可用性: Didit側で四半期あたり99.9%。下流の検証元の可用性は国やデータセットによって異なります。

関連情報

最終更新日 2026年11月1日