メインコンテンツまでスキップ

PIN/OTP (ワンタイムパスワード)の検証

概要

このリクエストでは、ユーザーから受け取ったPIN/OTP がRakuten CPaaS で送信されたものと一致するかどうか確認することができます。

エンドポイント URL: https://api.cpaas.symphony.rakuten.net/twofa/v1/pin/$request_id

メソッド: POST

HTTP ヘッダー

パラメーター要否
Authentication必須Type: Bearer
Token: JWT Token
Accept必須application/json
Content-Type必須application/json; charset=UTF-8

リクエストボディスキーマ: application/json

パラメーター要否詳細/値
pin必須検証のため、顧客が入力した PIN を送信します

サンプルレスポンス

{
"pin": "12345678",
}

レスポンス:

成功した場合は、APIの呼び出しに対するレスポンスがJson形式で 200 OKとなります。失敗時のレスポンスの詳細は"エラーコード"を参照してください

パラメーター詳細
successtrue
result_code結果コードを参照する
result_message結果コードの詳細
client_referenceクライアント証明書はリクエストで指定されたときのみ返されます。"client reference" は "Additional/Advanced Options" の下で確認することができます。
request_idリクエストで提供された "request_id"が参照用として返されます。

正しい場合の PIN/OTP レスポンス

{
"success" : true,
"result_code" : 0,
"result_message" : "Request successfully submitted",
"client_reference": "...if provided during original request...",
"request_id" : "...the request_id provided in the request is returned for reference...",
}

誤った場合の PIN/OTP レスポンス

{
"result_code" : 211,
"result_message" : "The submitted PIN was not the expected PIN for this request",
}