メインコンテンツへスキップ
POST
ナイジェリアの国民識別番号(NIN)を、National Identity Management Commissionの登録簿と照合して検証します。セルフィーが必須です。NINに紐づく登録時の顔写真とセルフィーを顔照合し、両者が同一人物である場合にのみ記録が返されます。DiditはこのサービスをPOST /v3/database-validation/で提供しており、送信されたデータを公式な情報源と照合して、正規化された照合結果を受け取ることができます。

対応範囲

  • 対応範囲: ~ 100%
  • 国: ナイジェリア
  • サービスID: nga_national_id_facial
  • データ領域: 本人情報
  • カテゴリ: NationalIDRegistry

入力

  • 必須の入力: national_id、selfie
  • 任意の入力: first_name、last_name、date_of_birth、vendor_data
  • 同意: 不要
  • ワークフローでの利用: ワークフローで利用可能
  • 対応範囲: ~ 100%
  • 料金: 成功したクエリ1件あたり$0.35
このサービスが受け付ける書類のすべてに、照会に使う識別番号が記載されているわけではありません。書類から識別番号が抽出されない場合、このチェックは該当なしとして記録されます。データベースへの照会は行われず、料金も発生しませんが、国によっては実際のユーザーの大きな割合がこれに該当します。こうしたユーザーにも対応するには、アンケートの回答、Document AIの抽出フィールド、またはセッション作成時に送信する値からも識別番号を取得し、データベース検証ステップでマッピングしてください。

ボディパラメーター

string
デフォルト:"NGA"
必須
このデータベースサービスのISO 3166-1 alpha-3の国コードです。例:NGA
string
デフォルト:"nga_national_id_facial"
必須
このサービスIDを含む配列です。サービスを固定することで、リクエストの対象をこのデータベースに限定できます。例:nga_national_id_facial
string
デフォルト:"11111111111"
必須
このサービスで使用する国民識別番号です。例:11111111111
file
必須
生体認証データベースでの検証のためにアップロードするセルフィー画像ファイルです。対応形式はJPEG、PNG、WebPです。例:@./selfie.jpg
string
検証する名です。例:John
string
検証する姓です。例:Doe
string
YYYY-MM-DD形式の生年月日です。例:1990-01-01
string
デフォルト:"user-1234"
社内のユーザーIDなど、この人物を識別するための固定のユーザー参照値です。Diditはこの値を使って単体のチェックを同一のエンドユーザーに紐づけ、重複検出のノイズを減らします。例:user-1234

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

  • first_nameは[A-Za-zÀ-ÖØ-öø-ÿ .'-]+に一致する必要があります。
  • national_idは数字のみで構成する必要があります。リクエストを送信する前に、スペース、ハイフン、句読点を取り除いてください。
  • national_idはちょうど11文字である必要があります。

呼び出し方法

返されるデータ

source_dataに含まれる具体的なフィールドは、登録簿が返す内容によって異なります。nga_national_id_facialの生成された例では、現在次の正規化された構造が示されています。
  • address
  • birth_country
  • birth_lga
  • birth_state
  • date_of_birth
  • face_match_score
  • first_name
  • gender
  • identification_number
  • last_name
  • marital_status
  • middle_name
  • phone_number
  • photo_available
  • residence_lga
  • residence_state
  • residence_town

料金とSLA

ナイジェリア国民ID + セルフィー(NIMC)のクエリは、Diditが検証元から確定した結果を受け取った場合にのみ課金されます。
  • 1回あたりの料金: $0.35 USD。
  • 請求: 成功したクエリごとに課金されます。レジストリにアクセスできない場合、必須フィールドが不足している場合、またはリクエストが検証元に到達する前に拒否された場合は課金されません。
  • レイテンシ: 通常、p95で2秒未満。
  • 可用性: Didit側で四半期あたり99.9%。下流のデータソースの可用性は国やデータセットによって異なります。

セルフィーと顔照合

NIMCの登録簿は、有効なNINに対して保有者の完全な記録を返すため、番号を知っていることはその所有者であることの証明になりません。そのため、すべての照会はセルフィーと紐づけられます。セルフィーはNIMCがそのNINについて保有する登録写真と顔照合され、両者が同一人物である場合にのみ記録が返されます。
  • 一致: source_dataにNIMCの記録とface_match_scoreが含まれます。送信した氏名と生年月日はこの記録と比較され、結果がvalidationに報告されます。氏名と生年月日の判定が必要な場合はこれらを送信し、不要な場合は省略して登録簿上の値をsource_dataから読み取ってください。
  • 別人: BIOMETRIC_NO_MATCH。face_match_scoreのみが返され、個人データは返されません。
  • 照合不可: NIMCがそのNINの写真を保有していない場合、または顔を検出できなかった場合はINCONCLUSIVEとなります。何も返されず、チェックはレビューに回されます。
  • 不明なNIN: DOCUMENT_NOT_FOUND。この照会は課金されます。
ワークフローでは、セルフィーはライブネス検知または顔照合のステップから取得されます。ワークフローに顔のステップがない場合は、アップロードされた書類の顔写真から取得されます。セルフィーのないリクエスト、またはNINが11桁でないリクエストは、課金が発生する前に拒否されます。

関連情報

最終更新日 2026年11月1日