ジャンプ先

• リクエスト
• レスポンス
• 例

チャレンジ・カウンタのリセット

delete

/customercare/v1/{customerId}/counters

特定のユーザーのチャレンジ失敗カウンタをリセットします。questionIdまたはchallengeTypeを指定する必要がありますが、両方は指定できません。

リクエスト

パス・パラメータ

• customerId(required): string
  ユーザーのuniqueUserIdです。詳細は、ユーザー・プリファレンスAPIを参照してください。

問合せパラメータ

• challengeType: string
  指定した場合、指定されたchallengeTypeの失敗カウンタがリセットされます。これは、challenge.type.enumのいずれかです。
• questionId: integer
  指定した場合、指定された質問IDの失敗カウンタがリセットされます
• requestId(required): string
  ユーザーのセッションのリクエストID(セッションID)。

この操作にはリクエスト本文はありません。

先頭に戻る

レスポンス

サポートされているメディア・タイプ

• application/xml
• application/json

200レスポンス

成功

本文()

ルート・スキーマ: StatusResponse

型: object

APIコールのステータス情報

ソースを表示

• responseCode: string
  リクエストのステータス・コード
• responseMessage: string
  レスポンス・コードに関連するレスポンス・メッセージ(必要に応じて)。
• sessionId: string
  認証のセッションID。
• status: boolean
  認証更新リクエスト・ステータス

{
    "type":"object",
    "description":"Status information for API call",
    "properties":{
        "responseCode":{
            "type":"string",
            "description":"status code of the request"
        },
        "responseMessage":{
            "type":"string",
            "description":"response message related to the response code if needed."
        },
        "status":{
            "type":"boolean",
            "description":"authentication update request status"
        },
        "sessionId":{
            "type":"string",
            "description":"session id of the authentcation."
        }
    }
}

400レスポンス

無効な入力

404レスポンス

顧客IDが見つかりません

先頭に戻る

例

次の例は、特定のユーザーのチャレンジ失敗カウンタをリセットするサンプルのリクエストとレスポンスを示しています。

JSON形式でチャレンジ失敗カウンタをリセットするcURLコマンド

curl --location --request DELETE '<RISKCC>/risk-cc/customercare/v1/{customerId}/counters?requestId=edbe55c6-438f-448f-a742-9925b6471fe1challengeType=ChallengeOMATOTP' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <Base64Encoded(<username>:<password>)>'

JSON形式のサンプル・レスポンス

{
    "responseCode": "0",
    "responseMessage": "",
    "status": true
}

XML形式でチャレンジ失敗カウンタをリセットするcURLコマンド

curl --location --request DELETE '<RISKCC>/risk-cc/customercare/v1/{customerId}/counters?requestId=edbe55c6-438f-448f-a742-9925b6471fe1challengeType=ChallengeOMATOTP' \
--header 'Content-Type: application/xml' \
--header 'Accept: application/xml' \
--header 'Authorization: Basic <Base64Encoded(<username>:<password>)>'

XML形式のサンプル・レスポンス

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<StatusResponse>    
    <responseCode>0</responseCode>
    <responseMessage></responseMessage>
    <status>true</status>
</StatusResponse>

先頭に戻る