一、接口说明
本文档将详细说明VSaaS平台强绑设备到新账户的接口（解决用户退货未解绑设备的场景，支持将设备强制绑定到新账户）。前置条件：所有接口调用前需获取对应权限的 Token（服务器 Token/用户 Token），且调用者需具备对应操作权限（如设备所有权、服务器级授权）。
二、强绑设备接口
适用于用户退货却未进行设备解绑的场景，支持将设备强制绑定到新账户。调用前需确保：
1. 设备UID已被其他账户绑定；
2. 新绑定的账户已在 VSaaS 平台注册（有登录记录）；
3. 使用服务器级 VSaaS Token 调用。
1. 设备UID已被其他账户绑定；
2. 新绑定的账户已在 VSaaS 平台注册（有登录记录）；
3. 使用服务器级 VSaaS Token 调用。
通过 PATCH 方式将指定设备UID强制绑定到新账户（邮箱/用户ID/手机号），解决设备被原用户占用的问题。
请求说明
| 项 | 说明 |
|---|---|
| HTTP请求方式 | PATCH |
| 请求URL | https://<vsaas_domain>/vsaas/api/v1/ss/device_chown/<device_uid>/<new_account> |
| 请求头（Header） | Authorization: Bearer {server_token}（服务器级 Token） Content-Type: application/json（可选） |
请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| device_uid | String | 是 | 设备唯一标识（UID） |
| new_account | String | 是 | 新绑定的账户标识：邮箱、用户ID或手机号 |
响应说明
响应状态码
| 状态码 | 徽章 | 说明 |
|---|---|---|
| 200 | 成功 | 强绑成功，设备归属权变更 |
| 400 | 参数错误 | 设备UID为空、新账户格式错误、设备未被绑定 |
| 401 | 授权失败 | 服务器 Token 无效或过期 |
| 404 | 资源不存在 | 设备UID不存在、新账户未注册 |
请求示例（curl）
curl --location --request PATCH 'https://cn-vpapi-tutk-stg.kalay.net.cn/vsaas/api/v1/ss/device_chown/11111111111111111111/[email protected]' \
--header 'Authorization: Bearer {server_token}'
响应示例（成功）
{
"code": 200,
"message": "Device ownership changed successfully",
"data": null
}
