外观
注销宿主账号
校验密码后注销当前宿主账号。界面应在用户明确选择注销后再调用。
POST /app/auth/deactivate
调用方: 随附宿主应用 · 认证: PHPSID 宿主会话
浏览器发送 PHPSID Cookie;原生端也可发送同名请求头。先通过宿主账号登录。
请求参数
JSON Body
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
password | string | 是 | 当前密码,非空,最长 72 字符。 |
请求示例
bash
curl 'https://example.com/app/auth/deactivate' \
-H "PHPSID: $POPOIM_SESSION" \
-H 'Content-Type: application/json' \
--data '{"password":"<当前密码>"}'使用说明
- 成功时 data=null,宿主应清理本地登录状态并退出 SDK。
- 仍是群主时不能注销,先处理所拥有的群。
返回参数
成功响应的最外层字段如下。下面所有业务字段都位于 data 中。
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 0 表示成功;非 0 时查看 msg,不把 data 当成功结果使用。 |
msg | string | 成功通常为 ok,失败时为错误说明。 |
data | null | 成功时为 null,没有额外业务数据。 |
返回示例
示例展示字段结构;ID、时间和资料仅作说明,请使用实际回包。
json
{
"code": 0,
"msg": "ok",
"data": null
}错误处理
密码错误为 3001,仍拥有群时为 3012。
先检查 HTTP 状态,再检查 code。业务失败可能仍为 HTTP 200;非 0 的 code 都不能当成功。完整错误码见请求约定。
