アカウントのパスワードのリセット

この記事の内容
  1. 事前操作
  2. リクエスト
  3. リクエストヘッダー
  4. リクエストパラメータ
  5. レスポンス
  6. レスポンスデータ構造
  7. 使用例
  8. パスワードの変更に成功
  9. パスワードの変更に失敗

api.example.com、console.example.com、files.example.com は説明用のアドレスです。実際の環境で指定された API、管理画面、ファイル配布先の URL に置き換えてください。

事前操作

  1. 認証インターフェースを使用してaccessTokenを取得します。

リクエスト

基本 パラメータ値 説明
HTTP URL https://api.example.com/oapi/useracl/v1/rest/pwd
HTTP Method POST

リクエストヘッダー

基本 パラメータ値 説明
Authorization Bearer {accessToken} {accessToken}変数は、認証インターフェースが返すaccess Tokenに置き換える必要があります

リクエストパラメータ

名称 タイプ 説明
loginAccount string アカウント(変更対象のアカウントを指定します)、送信必須
oldPwd string 旧パスワード。変更時に現在のパスワードと照合する必要があります
pwd string 新しいパスワード。空にはできません

レスポンス

レスポンスデータ構造

名称 タイプ 説明
data object 結果データ
code integer 戻り値の結果コード。200は成功、その他のエラー結果はすべて500です
success boolean trueは成功、falseは失敗を示します
requestId string
msg string 結果情報

使用例

パスワードの変更に成功

curl --location --request POST 'https://test-api.example.com/oapi/useracl/v1/rest/pwd' \
--header 'Authorization: Bearer 2ab12245-769b-4f53-99ce-8bab9329efed' \
--header 'Content-Type: application/json' \
--data-raw '{
    "loginAccount":"七六@fckj",
    "oldPwd":"123456", 
    "pwd":"1234567"
}'

戻り値

{"data":true,"code":200,"success":true}

パスワードの変更に失敗

curl --location --request POST 'https://test-api.example.com/oapi/useracl/v1/rest/pwd' \
--header 'Authorization: Bearer 2ab12245-769b-4f53-99ce-8bab9329efed' \
--header 'Content-Type: application/json' \
--data-raw '{
    "loginAccount":"七六@fckj",
    "oldPwd":"123456", 
    "pwd":"1234567"
}'

戻り値

{"code":500,"success":false,"msg":"新密码不能与当前密码相同,请输入一个不同的新密码"}
OpenAPIの記事一覧ページの先頭へ ↑