注销 iOS VoIP 设备

退出账号、切换账号或 VoIP token 失效时，解除当前设备的来电推送绑定。

POST /app/sdk/push/unregister

调用方： SDK 客户端　·　认证： IM Token

请求头：Authorization: Bearer <IM Token>。先通过宿主后端获取 Token，再交给 SDK 使用。

请求参数

JSON Body

参数	类型	必填	说明
device_id	string	是	当前安装设备的稳定标识，1–128 位字母、数字、点、下划线、冒号或连字符。同一台设备持续使用同一个值。

请求示例

curl 'https://example.com/app/sdk/push/unregister' \
  -H "Authorization: Bearer $POPOIM_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"device_id":"office-ios-01"}'

使用说明

• Body 只包含 device_id。设备标识应与注册时相同。

返回参数

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

字段	类型	说明
code	integer	0 表示成功；非 0 时查看 msg，不把 data 当成功结果使用。
msg	string	成功通常为 ok，失败时为错误说明。
data	object	本次请求的业务结果，字段见下表。

data 字段

字段	类型	说明
registered	boolean	注销后为 false。

返回示例

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

{
  "code": 0,
  "msg": "ok",
  "data": {
    "registered": false
  }
}

错误处理

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

返回设备与推送接口列表 · HTTP 请求约定