このトピックでは、ローカル電話番号の認証プロセスについて説明します。
手順 1： POP APIオペレーションを呼び出して認証 URL をリクエストする
GetPhoneNumberIdentificationUrl オペレーションを呼び出して、ローカル電話番号認証用の URL を取得します。次のプロセスが実装されます。認証事前チェックの実行 -> 認証セッションの作成 -> 認証 URL の返却。
リクエストパラメータ
Ip: 必須。ユーザーの IP アドレス。モバイルネットワーク上のアウトバウンドパブリック IP アドレスに値を設定する必要があります。PhoneNumber: 必須。認証対象の電話番号。OutId: 必須。外部システム ID。 OutId パラメータの値は、同じ認証プロセス内で一致している必要があることに注意してください。AuthCode: 必須。認証コード。RememberPhoneNumber: 電話番号を記録するかどうかを指定します。デフォルト値：true。
レスポンスパラメータ：
SessionId: セッション ID。IdentificationUrl: 認証 URL。
エラーコード：
IdentificationNotAvailable: 電話番号または IP アドレスは認証をサポートしていません。課金されません。
正常なレスポンスの例：
{ "RequestId": "E62823DB-749B-16DD-8BBA-A5EEC1DE7C7C", "Message": "OK", "Data": { "IdentificationUrl": "https://global-ip-auth.dycpaas.com/global/biz/ip_auth/start?ipa_s_c_c=IPF0000000000000000001&ipa_s_i=f80623095e9aa807151032af385a7173.66344ead-9fd0-4f66-80d2-c86fc22d9178.c9be5054d7e9428590da0afd712ef17c.1685504264240&ipa_o_i=66344ead-9fd0-4f66-80d2-c86fc22d9178&ipa_p_n=62088991133003&ipa_r_u=https%3A%2F%2Fglobal-ip-auth.dycpaas.com%2Fglobal%2Fbiz%2Fip_auth%2Ffinish%3Fipa_s_i%3Df80623095e9aa807151032af385a7173.66344ead-9fd0-4f66-80d2-c86fc22d9178.c9be5054d7e9428590da0afd712ef17c.1685504264240%26ipa_o_i%3D66344ead-9fd0-4f66-80d2-c86fc22d9178", "SessionId": "f80623095e9aa807151032af385a7173.66344ead-9fd0-4f66-80d2-c86fc22d9178.c9be5054d7e9428590da0afd712ef17c.1685504264240" }, "Code": "OK" }
手順 2： HTTP で認証を開始する
ユーザ端末は、手順 1：POP API オペレーションを呼び出して認証 URL をリクエストする で返された認証 URL にアクセスするために、モバイルネットワーク経由でリクエストを開始する必要があります。
この API オペレーションは、HTTP 経由でリクエストを開始します。レスポンスパラメータは、手順 1 で呼び出した POP API オペレーションで返されたものとは異なります。大文字と小文字が区別されます。レスポンスパラメータには、session_id、session_payload、out_id、success、message が含まれます。違いに注意してください。
正常なレスポンスの例
{
"session_payload": "EPj1vz1a3K51dvIolwRIuNwxrHuUsuaM/pl7PqGMnFblAzKIqJEagGTV5JsNB/3LkLuOl53NV63TUUsIDJ6G68W39bF39q/VGlszVboQnitFoV+kfZ1B/nydwrWhk7peSsKm1SaFDGmyUyyW27vx7cKW67vLB4LfWVZErDEngHteoxKqCQT6+hCFCw/MboqrfNOsWK0MnUx++xL4sH7421J9FcBXtEwDt6j9qmEcGWwOXYL9M4IkpMIsGOzakJqEAIoHX2DWDtOV8xTTvTDsergdEmKEYjvutqdZmwrkomHdb/6OeZM7wrexls2GdhMxxgmSpib7q7zMBUEbMUz+T+pTCYK0duLeRYD8ePG34oF/bq8jQi7hR4K2okfxAc36gL7ntrgSrdeUkNgPqEJ0/q6e3FioCxz4lyqxi0zjFz5Tyn9k5WIYV7GjDt5Mv4oW0ZPXW4QUUur7fp73ydhq7oFBK5webPwMdrqVPH10UzvuRH5P3Y8buV8WK75vaRXOIvgWBLEyypeuwGCVcGJ3X84iP+RKN2wCB0ggnlAm5kG+tlZ88Ly9lg==",
"success": true,
"session_id": "fb6cf28b819808b8437b37c1d77c73e4.out.1233.d6655b6c055f44cc8d897bc3583806e8.1683880287678",
"out_id": "hwding",
"message": "ok"
}エラーレスポンスの例
{
"success": false,
"session_id": "fb6cf28b819808b8437b37c1d77c734.out.1233.d6655b6c055f44cc8d897bc3583806e8.1683880287678",
"out_id": "hwding",
"message": "Invalid or expired session.",
"code": "SessionNotValid"
}手順 3： POP API オペレーションを呼び出して認証結果を取得する
GetPhoneNumberIdentificationResult オペレーションを呼び出して、ローカル電話番号認証の結果を取得します。
認証結果が返された後、セッションの結果を繰り返しクエリすることはできません。結果を保存する必要があります。
リクエストパラメータ
SessionId: 必須。セッション ID。SessionPayload: 必須。このパラメータを、手順 2：HTTP で認証を開始する で返された session_payload の値に設定します。PhoneNumber: 必須。認証対象の電話番号。OutId: 必須。外部システム ID。 OutId パラメータの値は、同じ認証プロセス内で一致している必要があることに注意してください。AuthCode: 必須。認証コード。
レスポンスパラメータ：
IsIdentified: 認証が成功したかどうかを示します。エラーコード：
NoIdentificationResult: 認証結果が返されません。
SessionNotValid: セッションが無効または期限切れです。
正常なレスポンスの例：
{ "RequestId": "5C1DE9E0-8EA9-171B-9893-3E2881D981C9", "Message": "OK", "Data": { "IsIdentified": true }, "Code": "OK" }