解绑设备
解绑仅清空设备上的外部用户信息，不删除角色绑定或已有聊天记录；但该用户将无法再通过 Open API 查询对应硬件会话。
请求信息
请求 URI
DELETE https://lg.jimitu.top/api/open/channels/{channel_id}/bind-device请求头参数
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer {API Key}，接口鉴权，所有请求均需携带 |
Content-Type | 否 | 仅 POST/PUT 携带 JSON 请求体时需要，值为 application/json |
请求路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel_id | integer | 是 | 硬件渠道 ID |
请求体参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| device_id | string | 是 | 待解绑设备 ID |
| product_key | string | 否 | 产品型号 ID；设备 ID 需要消歧时填写 |
| external_user_id | string | 是 | 必须与设备当前绑定的外部用户 ID 一致，防止误解绑 |
请求示例
curl -X DELETE "https://lg.jimitu.top/api/open/channels/{channel_id}/bind-device" \
-H "Authorization: Bearer <your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"device_id": "123456",
"product_key": "（可选，消歧用）",
"external_user_id": "<user_id>"
}'响应信息
响应体示例
{
"success": true,
"message": "External user unbound from device successfully",
"data": {
"device_id": "123456",
"product_key": "...",
"channel_id": 100,
"binding_id": 999,
"character_id": 555,
"external_user_id": "<user_id>",
"external_user_nickname": "...",
"unbound": true
}
}响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| device_id | string | 设备 ID |
| product_key | string | 产品型号 ID |
| channel_id | integer | 渠道 ID |
| binding_id | integer | 绑定记录 ID |
| character_id | integer | 角色实例 ID |
| external_user_id | string | 外部用户 ID |
| external_user_nickname | string | 外部用户昵称 |
| unbound | boolean | 是否已解绑 |
错误码
错误码
| 场景 | error_code | HTTP |
|---|---|---|
| 外部用户 ID 与设备当前绑定不一致 | EXTERNAL_USER_MISMATCH | 409 |
| 设备未绑定外部用户 | DEVICE_EXTERNAL_USER_NOT_BOUND | 409 |
| 其余校验同 POST bind-device | 同左 | 同左 |