shareDeviceList（分页获取 easy4ip 应用分享设备列表）

shareDeviceList：分页获取 easy4ip 应用分享设备列表

遗留 HTTP 保留： 供已有对接继续调用。新接入请见设备 API 总览。

遗留 HTTP： 供已有对接继续调用。新接入请从设备 API 总览与 V2 查询方法选型。

相关当前接口： 本方法仍为当前路径上的 legacy HTTP。分页设备详情（device.detail.page，source=share）只作相关入口，不是一对一替代。

功能说明

分页获取 easy4ip 应用分享给开发者的设备列表。

请求地址

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

请求格式

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

请求参数

参数名	参数类型	是否必填	默认值	合法取值	参数说明
token	String	是			管理员 accessToken
queryRange	String	是		数值范围 [1,N]（N 为正整数，且后者大于前者）；区间长度 [0, 99]	查询数据条数上限

请求示例

{
 "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system":{
 "ver":"1.0",
 "appId":"lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time":1599031074,
 "nonce":"8ec8a7bd1d1c95420de20d92422d457d"
 },
 "params":{
 "token":"At_00006acr3456d12312d3grf60147de7ec",
 "queryRange":"1-10"
 }
}

返回 data 字段

字段名	字段类型	字段说明
count	Integer	设备总数
deviceList.deviceId	String	设备序列号
deviceList.status	Integer	设备状态：1 在线，0 离线
deviceList.baseline	String	设备基线类型
deviceList.deviceModel	String	设备型号
deviceList.deviceCatalog	String	设备品类 [NVR/DVR/HCVR/IPC/SD/IHG/ARC]
deviceList.brand	String	设备品牌：lechange 为 Imou 设备，general 为通用设备
deviceList.channels.resolutions.name	String	设备名称
deviceList.channels.resolutions.ability	String	设备能力项，逗号分隔，详见设备能力集说明
deviceList.channels.canBeUpgrade	Boolean	是否有可升级的新版本：true 有，false 无
deviceList.channels.ownerUsername	String	设备所有者账号
deviceList.channels.platForm	Integer	设备接入平台编号：0 仅支持 P2P；1 旧版 easy4ip 接入平台；2 easy4ip 开放平台接入；3 国内常规接入；4 国内扩展接入（建议结合 bindDeviceInfo）；-1 未知平台
deviceList.channels.encryptMode	String	加密模式：0 默认加密，1 用户自定义加密
deviceList.channels.playToken	String	设备播放码，供 OpenSDK 使用
deviceList.channels.channelId	String	通道号
deviceList.channels.channelName	String	通道名称
deviceList.channels.channelOnline	Boolean	是否在线：true 在线，false 离线
deviceList.channels.channelPicUrl	String	缩略图 URL
deviceList.channels.channelAbility	String	通道能力集，如 AlarmMD、AudioTalk，逗号分隔
deviceList.resolutions.name	String	客户端展示的分辨率名称
deviceList.resolutions.imageSize	Integer	分辨率枚举值
deviceList.resolutions.streamType	Integer	码流类型：0 高清主码流，1 标清辅码流

响应示例

{
 "result":{
 "msg":"操作成功.",
 "code":"0",
 "data":{
 "count":1,
 "deviceList":[{
 "deviceId":"TESTQWERXXXX",
 "status":1,
 "baseline":"ABC",
 "deviceModel":"CE-A-TP1",
 "deviceCatalog":"SD",
 "brand":"lechange",
 "version":"Chn_A_V1.1",
 "name":"deviceName",
 "ability":"AlarmMD,AudioTalk,AlarmPIR,WLAN,VVP2P",
 "canBeUpgrade":false,
 "ownerUsername":"13512341234",
 "platForm":4,
 "encryptMode":"0",
 "playToken":"qwejhfdhrubfsdbisjfasnd",
 "channels":[{
 "channelId":"0",
 "channelName":"channelName",
 "channelOnline":true,
 "channelPicUrl":"http://xxx.xx.com/xxx/3.jpg",
 "channelAbility":"WLAN,PTZ,AudioTalk",
 "resolutions":[{
 "name":"1080P",
 "imageSize":18,
 "streamType":0
 }]
 }]
 }]
 }
 },
 "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af"
}

错误码

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

网关与鉴权（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。