unBindDeviceInfo（获取未绑定设备信息）

unBindDeviceInfo：获取未绑定设备信息

已弃用： 新接入请使用绑定前信息（device.prebind.get）。本页仅供存量 HTTP 对接查阅。

功能说明

查询未绑定设备的信息。

请求地址

https://openapi-[DataCenter].easy4ip.com/openapi/unBindDeviceInfo

请求格式

POST JSON 请求体见请求约定；签名见签名。

子账号 token 权限

子账号 token 调用本接口无需校验权限。

请求参数

参数名	参数类型	是否必填	参数说明
token	String	是	管理员或子账号 accessToken
deviceId	String	是	设备序列号
productId	String	否	型号设备产品 ID，可扫描设备二维码获取
deviceCodeModel	String	否	设备二维码型号，可扫描设备二维码获取
deviceModelName	String	否	设备市场型号
ncCode	String	否	设备配网能力，可扫描设备二维码获取

请求示例

{
 "id": "115d93268c8c4325920be6c9d3f5e855",
 "system": {
 "ver": "1.0",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "appId": "lcdxxxxxxxxx",
 "time": 1404443389,
 "nonce": "169431af9750408da8aeeb7d07f93c4e"
 },
 "params": {
 "token": "At_12345678901234567890123456789012",
 "deviceId": "TESTQWERXXXX",
 "deviceCodeModel": "TP1",
 "deviceModelName": "TP1-Popular Edition",
 "ncCode": "64"
 }
}

返回 data 字段

字段名	字段类型	字段说明
support	Boolean	平台是否支持该设备：true 支持，false 不支持
productId	String	型号设备产品 ID
deviceExist	String	设备是否在平台存在：exist 存在，notExist 不存在
status	String	设备状态：online 在线，offline 离线，upgrading 升级中，sleep 休眠
bindStatus	String	绑定状态：unbind 未绑定
wifiConfigMode	String	设备支持的配网模式：SmartConfig、SoundWave、SoftAP、LAN、SIMCard、QRCode、SoundWaveV2、NBIOT；蓝牙配件不返回
wifiConfigModeOptional	Boolean	是否支持用户选择可用配网方式：true 可选，false 不可选
wifiTransferMode	String	无线频段支持顺序：2.4Ghz、5Ghz
deviceCodeModel	String	设备上报型号
deviceModelName	String	设备市场型号
catalog	String	设备品类：NVR/DVR/HCVR/IPC/SD/IHG/ARC
ability	String	设备能力集
type	String	硬件类型：device 设备，ap 配件

响应示例

{
 "id": "115d93268c8c4325920be6c9d3f5e855",
 "result": {
 "data": {
 "support": true,
 "deviceExist": "exist",
 "status": "online",
 "bindStatus": "unbind",
 "wifiConfigMode": "SoundWave",
 "wifiConfigModeOptional": false,
 "wifiTransferMode": "2.4Ghz",
 "deviceCodeModel": "TP1",
 "deviceModelName": "TP1-Popular Edition",
 "catalog": "IPC",
 "ability": "WLAN,PT",
 "type": "device"
 },
 "code": "0",
 "msg": "操作成功."
 }
}

错误码

本接口可能返回下列码；完整分组见错误码与能力错误码。

网关与鉴权（SN / TK / OP）

错误码	错误码说明	下一步
`SN1001`	签名校验异常	按 HTTP 开发规范核对 `sign`
`TK1002`	token 无效或过期	重新获取 accessToken
`OP1002`	缺少必填参数	补必填字段
`OP1003`	参数不合法	按本页参数表核对
`OP1009`	权限不足	核对 token 与设备绑定/分享权限
`OP1013`	接口总次数超限	降低调用频率
`OP1014`	接口日限额超限	见接口调用限额
`DV1007`	设备离线	等设备上线

更多见错误码 · OP/SN/TK。

子账号（SUB）

错误码	错误码说明	下一步
`SUB1001`–`SUB1002`	子账号无接口权限	在 addPolicy 中补策略
`SUB1005`	子账号 token 过期	重新 subAccountToken
`SUB1006`	子账号与设备无授权	核对 `Resource` 与设备序列号
`SUB1008`	子账号未绑定应用	先创建并绑定子账号

更多见错误码 · SUB。

设备绑定（DV10xx）

错误码	错误码说明	下一步
`DV1001`	已被其他账号绑定	解绑或换设备
`DV1002`	设备不存在	核对序列号
`DV1003`	已被当前账号绑定	无需重复绑定
`DV1005`	验证码错误	核对设备机身码
`DV1008`	绑定数量超限	解绑冗余设备
`DV1011`	设备未绑定	先执行绑定
`DV1029`	设备已被绑定	勿重复绑定

更多见错误码 · DV。