アカウントパスワード変更API

アクセス権限
特権 サーバ管理 テナント管理 シナリオ設計 AIML編集者

アカウントのパスワード変更を行うAPIです。

エンドポイント

URL

https://sunaba.xaiml.docomo-dialog.com/NLPManagementAPI/accounts/password

リクエスト

Method PUT
Header Authorization ログインAPIで払い出したアクセストークンを指定します。
  Content-Type application/json;charset=UTF-8
Body JSON形式。(詳細はリクエストパラメータを参照)

レスポンス

ステータスコード 成功

  • 204(No Content) 

エラー

  • 400(Bad Request)
  • 401(Unauthorized)
  • 403(Forbidden)
  • 404(Not Found)
  • 409(Conflict)
  • 429(Too many requests)
Body 成功:なし エラー:JSON形式

URLパラメータ

URLパラメータはありません。

リクエストパラメータ

キー
必須 説明
old string 現在のパスワードを設定します。
現在のパスワードと一致しない場合、HTTPステータスコード400(Bad Request)を返却します。
一定回数連続で間違えるとHTTPステータスコード429(Too many requests)を返却し、アカウントをロックアウトします。
new string 新しいパスワードを設定します。
アカウント名と異なる値を設定してください。
パスワードは8文字以上180文字以内、英・数・記号の2つ以上を組み合わせて設定してください。
上記に該当しない場合、HTTPステータスコード400(Bad Request)を返却します。
過去に使ったパスワードのうち最近のものを指定した場合、HTTPステータスコード409(Conflict)を返却します。

レスポンスパラメータ

レスポンスパラメータはありません。

レスポンス例(エラー)

HTTPステータス/原因 レスポンス内容
400(Bad Request)
  現在のパスワード不正
  パスワード強度不足
401(Unauthorized)
  トークン不正 なし
  パスワードが期限切れもしくは旧式や初期パスワード なし
403(Forbidden)
  有効フラグ不正 なし
409(Conflict)
  再利用不正 なし
429(Too many requests)
  ロックアウト なし