一、接口說明
本文檔將詳細(xì)說明VSaaS平臺強(qiáng)綁設(shè)備到新賬戶的接口（解決用戶退貨未解綁設(shè)備的場景，支持將設(shè)備強(qiáng)制綁定到新賬戶）。
前置條件：所有接口調(diào)用前需獲取對應(yīng)權(quán)限的 Token（服務(wù)器 Token/用戶 Token），且調(diào)用者需具備對應(yīng)操作權(quán)限（如設(shè)備所有權(quán)、服務(wù)器級授權(quán)）。
二、強(qiáng)綁設(shè)備接口
適用于用戶退貨卻未進(jìn)行設(shè)備解綁的場景，支持將設(shè)備強(qiáng)制綁定到新賬戶。調(diào)用前需確保：
1. 設(shè)備UID已被其他賬戶綁定；
2. 新綁定的賬戶已在 VSaaS 平臺注冊（有登錄記錄）；
3. 使用服務(wù)器級 VSaaS Token 調(diào)用。
1. 設(shè)備UID已被其他賬戶綁定；
2. 新綁定的賬戶已在 VSaaS 平臺注冊（有登錄記錄）；
3. 使用服務(wù)器級 VSaaS Token 調(diào)用。
通過 PATCH 方式將指定設(shè)備UID強(qiáng)制綁定到新賬戶（郵箱/用戶ID/手機(jī)號），解決設(shè)備被原用戶占用的問題。
1. 請求說明
| 項 | 說明 |
|---|---|
| HTTP請求方式 | PATCH |
| 請求URL | https://<vsaas_domain>/vsaas/api/v1/ss/device_chown/<device_uid>/<new_account> |
| 請求頭（Header） | Authorization: Bearer {server_token}（服務(wù)器級 Token） Content-Type: application/json（可選） |
2. 請求參數(shù)
| 參數(shù)名 | 類型 | 必選 | 說明 |
|---|---|---|---|
| device_uid | String | 是 | 設(shè)備唯一標(biāo)識（UID） |
| new_account | String | 是 | 新綁定的賬戶標(biāo)識：郵箱、用戶ID或手機(jī)號 |
3. 響應(yīng)說明
3.1 響應(yīng)狀態(tài)碼
| 狀態(tài)碼 | 徽章 | 說明 |
|---|---|---|
| 200 | 成功 | 強(qiáng)綁成功，設(shè)備歸屬權(quán)變更 |
| 400 | 參數(shù)錯誤 | 設(shè)備UID為空、新賬戶格式錯誤、設(shè)備未被綁定 |
| 401 | 授權(quán)失敗 | 服務(wù)器 Token 無效或過期 |
| 404 | 資源不存在 | 設(shè)備UID不存在、新賬戶未注冊 |
4. 接口示例
請求示例（curl）
curl --location --request PATCH 'https://cn-vpapi-tutk-stg.kalay.net.cn/vsaas/api/v1/ss/device_chown/11111111111111111111/user2@qq.com' \
--header 'Authorization: Bearer {server_token}'
響應(yīng)示例（成功）
{
"code": 200,
"message": "Device ownership changed successfully",
"data": null
}
