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

セッションの中止

概要

セッションが不要になった場合に中止します。これにより、中止した "request_id" に対してそれ以上のメッセージが送信されなくなります。 進行中のワークフロー のステップはすべて中止されます。

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

メソッド: POST

HTTP ヘッダー

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

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

パラメーター要否詳細/値
request_id必須"request_id" は、新しい PIN が要求されたときにプラットフォームから返されます

レスポンス:

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

パラメーター概要
successTこのパラメーターはセッションの結果を表し、PIN が正しく送信された場合、PIN が正しく検証された場合などに"true" を返し、PIN が無効または間違っていた場合、またはセッションがキャンセルされた場合には "false" を返します。
result_code結果コードを参照する
result_message結果コードの詳細
client_referenceクライアント証明書はリクエストで指定されたときのみ返されます。"client reference" は "Additional/Advanced Options" の下で確認することができます。
request_idリクエストで提供された "request_id"が参照用として返されます。

サンプルレスポンス

{
"success" : false,
"result_code" : 215,
"result_message" : "The requested session has been cancelled",
"client_reference": "...if provided during original request...",
"request_id" : "...the request_id provided in the request is returned for reference..."
}