パスワード変更(\__mypassword)
概要
Accountのパスワードに関する操作を行うAPI
自アカウントのパスワード変更
自アカウントのパスワード変更を行う。
※ Account更新APIでもAccountのパスワード変更を行うことができるが、これはCell Level ACLのauth権限が必要で管理目的で利用する。
※ アカウントに対する変更のため、UnitUserTokenではなく、アカウント認証によるCellLocalTokenが必須となる。
※ アカウントのStatusが「passwordChangeRequired」の場合、「active」に更新される。
必要な権限
なし
リクエスト
リクエストURL
{CellName}/__mypassword
メソッド
PUT
リクエストクエリ
クエリは無視する
リクエストヘッダ
ヘッダ名 | 概要 | 有効値 | 必須 | 備考 |
---|---|---|---|---|
Authorization | OAuth2.0形式で、認証情報を指定する | Bearer {CellLocalToken} | ○ | 認証トークンは認証トークン取得APIで取得したセルローカルトークン |
X-Personium-Credential | 変更後パスワード | 文字列 | ○ | ※unitの設定のパスワード制限に従う デフォルトは以下の通り 文字数:6~32文字 文字種:半角英数字と下記半角記号 -_!$*=^`{|}~.@ |
リクエストボディ
なし
レスポンス
ステータスコード
204
レスポンスヘッダ
なし
レスポンスボディ
なし
エラーメッセージ一覧
エラーメッセージ一覧を参照
cURLサンプル
curl "https://cell1.unit1.example/__mypassword" -X PUT -i -H \
'X-Personium-Credential: change_password' -H 'Authorization: Bearer AA~4l...(省略)........auMhw' -H \
'Accept: application/json'