POST/api/v1/me/password设置 / 修改我的密码

Try it 面板需要启用 JavaScript。

已设密码时必须携带旧密码；OTP 注册、尚未设密码的用户首次设置无需旧密码。修改后非当前会话全部吊销。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`
Content-Type	string	Yes	请求体内容类型（默认值 "application/json"）

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
  /** 请求体内容类型，默认值 "application/json" */
  Content-Type: string
}

{
  "Authorization": "Bearer st_7c1f9e05b28d4a63",
  "Content-Type": "application/json"
}

Body

Name	Data Type	Required	Description
oldPassword	string	No	旧密码；已设密码时必填
newPassword	string	Yes	新密码（强度策略由服务端校验）

type RequestBody = {
  /** 旧密码；已设密码时必填 */
  oldPassword?: string
  /** 新密码（强度策略由服务端校验） */
  newPassword: string
}

{
  "oldPassword": "J8v#pQ2mXs!a",
  "newPassword": "K9w$eR3nYt@b"
}

Response

Body

result type: null

HTTP Code

HTTP Status	Meaning	Notes
200	成功	密码已更新
400	旧密码错误	oldPassword 不正确

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	密码已更新，非当前会话全部吊销
2401	旧密码错误	已设密码但 oldPassword 不匹配
2402	密码强度不足	不符合服务端强度策略

Examples

POST /api/v1/me/password
Authorization: Bearer st_7c1f9e05b28d4a63
Content-Type: application/json

{
  "oldPassword": "J8v#pQ2mXs!a",
  "newPassword": "K9w$eR3nYt@b"
}

{
  "id": "01JD8SNVCP4W7X3DX",
  "code": 0,
  "messages": [],
  "result": null
}

Remarks

修改成功后除当前会话外的全部会话立即吊销，是凭据变更的标准保护动作。