跳转到正文

修改宿主密码 ​

校验当前密码后设置新密码。

POST /app/auth/password

调用方: 随附宿主应用 · 认证: PHPSID 宿主会话

浏览器发送 PHPSID Cookie;原生端也可发送同名请求头。先通过宿主账号登录。

请求参数 ​

JSON Body ​

参数类型必填说明
current_passwordstring是当前密码,非空,最长 72 字符。
new_passwordstring是新密码,6–72 字符。

请求示例 ​

bash
curl 'https://example.com/app/auth/password' \
  -H "PHPSID: $POPOIM_SESSION" \
  -H 'Content-Type: application/json' \
  --data '{"current_password":"<当前密码>","new_password":"<新的账号密码>"}'

使用说明 ​

  • 成功时 data=null。账号密码不正确或账号不可用时,按返回的错误处理。

返回参数 ​

成功响应的最外层字段如下。下面所有业务字段都位于 data 中。

字段类型说明
codeinteger0 表示成功;非 0 时查看 msg,不把 data 当成功结果使用。
msgstring成功通常为 ok,失败时为错误说明。
datanull成功时为 null,没有额外业务数据。

返回示例 ​

示例展示字段结构;ID、时间和资料仅作说明,请使用实际回包。

json
{
  "code": 0,
  "msg": "ok",
  "data": null
}

错误处理 ​

先检查 HTTP 状态,再检查 code。业务失败可能仍为 HTTP 200;非 0 的 code 都不能当成功。完整错误码见请求约定。

返回随附宿主账号接口列表 · HTTP 请求约定