本人確認または住所確認の証明書類を添付する
この手順は、本人情報または住所を作成し、必要なファイルを create_encrypt_files で選択した証明書類の種類に従ってアップロードした後に実行してください。現在有効なIDの取得元は get_proof_types です。要件とエンティティのカテゴリに一致するIDを使用してください。
identity_id と address_id を保存してください。これらの取得元は create_document です。プロフィールの UUID は別の識別子です。新規作成したプロフィールに後から住所確認の証明書類を添付できるかどうかは、引き続き確認中です。住所が拒否された場合は、再試行する前にポータルで確認するか、サポートに問い合わせてください。
証明書類の関連付けを作成する
有効な MultiTEL API アカウントと、そのアカウントで許可されたIPアドレスを使用してください。例では、環境変数から取得した HTTP Basic 認証の認証情報を使用しています。ご利用のアカウント種別の認証方式に従ってください。リクエストは HTTPS で送信してください。HTTP レスポンスに加え、JSON 内の次の値も確認してください：status.code。HTTP 200 でもアプリケーションエラーが返されることがあります。以下の例は架空のものです。
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--header 'Content-Type: application/json' \
--data @proof-request.json \
https://api.multitel.net/v3/create_proof{
"entity_type": "identities",
"entity_id": "33333333333333333333333333333333",
"proof_type_id": "11111111111111111111111111111111",
"encrypted_file_ids": [
"22222222222222222222222222222222"
]
}| フィールド | 意味 |
|---|---|
entity_type | identities または addresses を使用してください。関連付けの対象とアップロード済みファイルの両方に一致するカテゴリを選択してください。 |
entity_id | ご利用のアカウントが所有する本人情報または住所のIDです。書類処理のワークフローで返された識別子を使用してください。電話番号や無関係な書類のIDで代用しないでください。 |
proof_type_id | 選択した証明書類の種類のIDです。アップロード時の種類および要件と一致させてください。 |
encrypted_file_ids | create_encrypt_files が返したファイルIDを格納する、空でない JSON 配列です。ファイルは同じアカウントに属し、有効期限内であり、エンティティのカテゴリと一致している必要があります。ローカルのファイルパスの一覧ではありません。 |
フォームデータも受け付けます。その場合は、同じ名前で繰り返し指定する encrypted_file_ids[] フィールドを使用してください。実際の JSON 配列またはフォーム配列を使用することを推奨します。JSON 形式にエンコードした配列を、通常のスカラー値のフォーム項目として送信しないでください。
証明書類の関連付けのIDを保存する
{
"status": {
"code": 200,
"msg": "Proof created successfully."
},
"response": {
"id": "44444444444444444444444444444444",
"entity_type": "identities",
"entity_id": "33333333333333333333333333333333",
"proof_type_id": "11111111111111111111111111111111",
"proof_type_name": "Example identity proof"
}
}成功レスポンスは、証明書類の関連付けが作成されたことを示します。本人情報や住所の承認、国ごとのすべての要件への適合確認、電話番号の有効化を示すものではありません。
エラーとアップロード済みファイルの有効期限切れ
API コード 500 は、必須入力の不足、通信事業者側の障害、通信事業者からの不正なレスポンスに使用されます。コード 404 は、対象が現在のアカウントに関連付けられていない場合、証明書類の種類が無効な場合、このアカウントとカテゴリに該当するアップロード済みファイルが見つからないか有効期限切れの場合、または使用可能なファイルIDが残っていない場合に使用されます。status.msgをコードと併せて確認してください。
必要なファイルの有効期限が切れている場合は、正しい証明書類カテゴリで再アップロードしてから添付してください。指定したファイルが一つでも無効な場合、このハンドラーは証明書類の関連付けを作成するリクエストを送信する前に処理を停止します。冪等性キーは提供されていません。タイムアウトした場合は、添付を再試行する前に、ポータルで既存の書類を確認してください。