メインコンテンツへスキップ
POST
グローバルなリスクインサイトネットワークを通じて、メールアドレスと電話番号のいずれかまたは両方から、人物情報(氏名、生年月日、住所、電話番号、メールアドレス、国民ID)と氏名一致スコアを特定します。リクエストごとに課金されます。DiditはこのサービスをPOST /v3/database-validation/で提供しており、送信したデータを連携先のアイデンティティネットワークと照合して、正規化された一致結果を受け取れます。これはサードパーティのエンリッチメントネットワークであり、政府の公式登録簿ではありません。その結果を一次情報源による検証として提示しないでください。

対象範囲

  • 対象範囲: 50+の市場
  • 国: グローバル
  • サービスID: glb_identity_enrichment
  • データドメイン: アイデンティティ
  • カテゴリ: IdentityEnrichment

入力

  • 必須の入力: なし
  • 任意の入力: email、phone、first_name、last_name、full_name、country_of_residence、vendor_data
  • 同意: 必須
  • ワークフローでの利用: スタンドアロンAPIのみ
  • 対象範囲: 50+の市場
  • 料金: 成功したクエリ1件あたり$0.20
このサービスは、ワークフロー内のデータベース検証ステップとしては提供されていません。これはチェックを実行できる場所の制限であり、送信できる内容の制限ではありません。スタンドアロンAPIを呼び出し、入力を直接指定してください。

ボディパラメーター

string
デフォルト:"GLB"
必須
このデータベースサービスのISO 3166-1 alpha-3国コードです。例:GLB
string
デフォルト:"glb_identity_enrichment"
必須
このサービスIDを含む配列です。サービスを固定することで、リクエストの対象をこのデータベースのみに限定できます。例:glb_identity_enrichment
このサービスに対するエンドユーザーの明示的な同意です。例:true
string
デフォルト:"john.doe@example.com"
メールアドレスです。例:john.doe@example.com
string
デフォルト:"+15550101000"
国際形式の電話番号です。例:+15550101000
string
デフォルト:"John"
検証する名です。例:John
string
デフォルト:"Doe"
検証する姓です。例:Doe
string
検証する法的な氏名です。例:John Doe
string
デフォルト:"US"
居住国を表すISO 3166-1 alpha-2コードです(任意)。本人情報の検索対象を絞り込むためにのみ使用されます。例:US
string
デフォルト:"user-1234"
社内ユーザーIDなど、この人物を一貫して識別するためのユーザー参照です。Diditはこれを使用して、スタンドアロンのチェックを同一のエンドユーザーに紐付け、重複検知のノイズを減らします。例:user-1234

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

  • emailまたはphoneの少なくとも一方を指定してください。これらが検索キーです。どちらも含まないリクエストはエンリッチメント検索を実行できず、ソースでの検索前に拒否されます(課金されません)。
  • 名前がわかる場合は必ず追加してください。ソースはその名前に基づいて検索をスコアリングします。first_nameとlast_nameを送信してください。これらはレスポンスのvalidationマップが比較するフィールドです。full_nameのみを送信したリクエストもソースによってスコアリングされますが、validationは空になり、トップレベルのmatch_typeはnullで返されます。
  • country_of_residenceは、検索対象を絞り込むために使用されるISO 3166-1 alpha-2コードです。
  • 完了した検索はすべて課金されます。人物が1人も特定されなかった場合(persons_found: 0)も含みます。無料になるのは、検索前に拒否されたリクエスト(emailとphoneのどちらも指定されていないもの)のみです。

呼び出し方法

返却データ

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

料金とSLA

Global - Identity Enrichmentの照会は、Diditが検証ソースから確定的な結果を受け取った場合にのみ課金されます。
  • 呼び出し1件あたりの料金: $0.20 USD。
  • 請求: 成功した照会ごとに課金されます。登録機関に接続できない場合、必須フィールドが不足している場合、またはリクエストがソースに到達する前に拒否された場合は課金されません。
  • レイテンシ: 通常、p95で2秒未満。
  • 可用性: Didit側で四半期あたり99.9%。下流のソースの可用性は国やデータセットによって異なります。

関連情報

最終更新日 2026年11月1日