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