4. 解绑设备
描述:
解绑一或多台已经被当前用户绑定的设备,使设备回到未绑定状态。
请求说明:
| 协议 |
方法 |
PATH |
| HTTPS |
DELETE |
/openApi/device/deleteDevices |
Body参数:
| 参数 |
类型 |
必填 |
说明 |
| appId |
String |
是 |
appId |
| expires |
String |
是 |
过期时间 |
| sign |
String |
是 |
签名 |
| deviceNo |
String |
是 |
空字符串,固定值:”” |
| cmd |
String |
是 |
固定值:deleteDevices |
| data |
String |
是 |
设备编号数组字符串 |
| - deviceNos |
Array |
是 |
设备编号数组 |
返回参数:
| 参数 |
类型 |
必填 |
说明 |
| code |
int |
是 |
响应状态码 |
| msg |
String |
是 |
响应消息 |
| appId |
String |
是 |
appId |
| expires |
String |
是 |
过期时间 |
| sign |
String |
是 |
签名 |
| deviceNo |
String |
是 |
空字符串,固定值:”” |
| cmd |
String |
是 |
固定值:deleteDevices |
| data |
String |
是 |
响应数据 |
| - successes |
String |
是 |
解绑成功的设备数组字符串 |
| - - deviceNo |
String |
是 |
设备编号 |
| - failures |
String |
是 |
解绑失败的设备数组字符串 |
| - - deviceNo |
String |
是 |
设备编号 |
| - - error |
String |
是 |
错误响应对象字符串 |
| - - - code |
int |
是 |
错误码 |
| - - - message |
String |
是 |
错误消息 |
请求示例:
{"appId":"ym3b7f242fc0814489","expires":"1739583239","deviceNo":"","sign":"36f392b389e945b5c7ca8baa36fae53b","cmd":"deleteDevices","data":"{\"deviceNos\":\"[\\\"12345678-87654321\\\",\\\"123456789-987654321\\\"]\"}"}
返回示例:
{
"code": 0,
"msg": "操作成功",
"appId": "ym3b7f242fc0814489",
"expires": "1767601245",
"sign": "30c9a3cd183567250f924707406fd7bf",
"deviceNo": "",
"cmd": "deleteDevices",
"data": "{\"failures\":\"[{\\\"deviceNo\\\":\\\"123456789-987654321\\\",\\\"error\\\":{\\\"code\\\":1001,\\\"message\\\":\\\"未找到设备信息,设备未授权\\\"}}]\",\"successes\":\"[{\\\"deviceNo\\\":\\\"12345678-87654321\\\"}]\"}"
}