跳转到正文

注销宿主账号 ​

校验密码后注销当前宿主账号。界面应在用户明确选择注销后再调用。

POST /app/auth/deactivate

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

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

请求参数 ​

JSON Body ​

参数类型必填说明
passwordstring是当前密码,非空,最长 72 字符。

请求示例 ​

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

使用说明 ​

  • 成功时 data=null,宿主应清理本地登录状态并退出 SDK。
  • 仍是群主时不能注销,先处理所拥有的群。

返回参数 ​

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

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

返回示例 ​

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

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

错误处理 ​

密码错误为 3001,仍拥有群时为 3012。

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

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