# 摄像头列表查询（好望云平台）（API名称：getDeviceList） #### 功能介绍 用于与客户系统对接获取摄像头列表（好望云平台）。 #### 相关API | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 | | [获取设备信息](https://support.huaweicloud.com/api-isdp/api_01_0134.html) | 调用该接口获取设备信息。 | | [添加设备](https://support.huaweicloud.com/api-isdp/api_01_0123.html) | 调用该接口添加设备。 | | [修改设备](https://support.huaweicloud.com/api-isdp/api_01_0124.html) | 调用该接口修改设备。 | | [删除设备](https://support.huaweicloud.com/api-isdp/api_01_0125.html) | 调用该接口删除设备。 | | [保存设备模板](https://support.huaweicloud.com/api-isdp/api_01_0153.html) | 调用该接口保存设备模板。 | #### 调用流程 图1获取设备列表流程 ![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002522734613.png "点击放大") #### URL | **请求方式** | **HTTPS地址** | **服务架构** | **消息体类型** | |:---|:---|:---|:---| | POST | https://***isdp+域名***/openapi/v1/ivm/getDeviceList | OpenAPI | application/json | #### 请求头 | **KEY** | VALUE | 是否必填 | **描述** | |:---|:---|:---|:---| | Content-Type | application/json | 是 | 无 | | Authorization | bearer ${access_token} | 是 | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 | #### 请求参数 | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | page.count | Int | 是 | 分页参数-数量 | | page.start | Int | 是 | 分页参数-开始 | #### 响应参数 | **参数** | **类型** | **描述** | |:---|:---|:---| | isdpDeviceId | String | isdp唯一设备ID | | deviceId | String | 设备ID | | channelId | String | 通道ID | | deviceName | String | 设备名称 | | deviceState | String | 设备状态 | | accessProtocol | String | 接入协议 | | deviceType | String | 设备类型 | | deviceSystemState | String | 设备管理状态 | | description | String | 描述 | | model | String | 设备型号 | | manufacture | String | 生产厂商 | | channelTotal | int | 通道总数 | | streamTotal | int | 每个通道码流数量 | | firmware | String | 摄像头固件版本号 | | deviceAbility | String | 能力集 | | mac | String | mac地址 | | createTime | String | 创建时间 | | updateTime | String | 更新时间 | | protocolVersion | String | 协议版本 | | deviceIp | String | 设备ip | | devicePort | String | 设备端口 | | projectName | String | 项目名称 | | projectNumber | String | 项目编码 | | deviceAddress | String | 设备地址 | | fileId | String | 图片编号 | | sysType | String | 系统类型 | | fileSize | String | 文件大小 | | fileName | String | 文件名称 | | fileExt | String | 文件扩展名 | | deviceAddressNumber | String | 设备地址编号 | | deviceSubType | String | 子设备类型 | | deviceAlarmStatus | String | 设备告警状态 | | autoJoin | String | 是否主动入会 | | battery | String | 电量 | | ownnerId | String | 设备责任人ID | | longitude | String | 经度 | | latitude | String | 纬度 | | chatJid | String | IM群组ID | | chatId | String | IM聊天ID | | liveChannelId | String | 频道播放ID | | userName | String | 设备使用人名称 | | ownnerName | String | 设备责任人名称 | | webPlayUrl | String | web播放地址 | #### 请求示例 ``` { "page":{"count":10,"start":0} } ``` #### 响应示例 ``` { "status": 1, "message": "SUCCESS", "error": null, "data":{ "data":[ { "deviceId": "21024125389SL7002176", "isdpDeviceId": "21024125389SL7002176-0", "channelId": "0", "deviceName": "HoloSens SDC-0", "deviceState": "ONLINE", "accessProtocol": "HOLO", "deviceType": "WEBCAM", "deviceSystemState": null, "description": "", "model": "D3220-10-SIU", "manufacture": "huawei", "channelTotal": 0, "streamTotal": 0, "firmware": null, "deviceAbility": "intelligent,talk", "mac": null, "createTime": null, "updateTime": "2020-12-28 17:25:13", "protocolVersion": null, "deviceIp": null, "devicePort": null, "tenantId": 886, "projectNumber": "0001", "projectName": "XXXX项目", "deviceAddress": "XXXXXX基站", "fileId": "342955", "sysType": null, "fileSize": "106934", "fileName": "2020_12_28_17_29_04.jpg", "fileExt": "jpg", "deviceAddressNumber": "A0001", "webPlayUrl": "https://078dda04fc284058940039ebb5d0de25.APIgw.cn-north-4.xxxxxxxx.com/live/work003?app=vis&stream=XXXX", "verificationCode": "6h6yM3U1", "deviceManageState": "ACTIVATION", "deviceSubType": "IPC-CONCH", "creationDate": 1608968667000, "lastUpdateDate": 1609296597000, "lastUpdatedBy": null, "deviceAlarmStatus": "pulse", "autoJoin": null, "battery": null, "ownnerId": null, "longitude": null, "latitude": null, "chatJid": null, "chatId": null, "liveChannelId": null, "userName": null, "ownnerName": null }, { "deviceId": "3D2466559837484EDB7301977B8A0918", "isdpDeviceId": "3D2466559837484EDB7301977B8A0918-1", "channelId": "1", "deviceName": "IPC", "deviceState": "ONLINE", "accessProtocol": "holosens", "deviceType": "WEBCAM", "deviceSystemState": null, "description": "", "model": "HuaWeiSDC", "manufacture": "HUAWEI", "channelTotal": 0, "streamTotal": 0, "firmware": null, "deviceAbility": "", "mac": null, "createTime": null, "updateTime": null, "protocolVersion": null, "deviceIp": null, "devicePort": null, "tenantId": 886, "projectNumber": "hh6", "projectName": "h7", "deviceAddress": "sssssssssssssssssssssss", "fileId": null, "sysType": null, "fileSize": null, "fileName": null, "fileExt": null, "deviceAddressNumber": "ddddddddd", "webPlayUrl": null, "verificationCode": "H7WnS74f", "deviceManageState": "ACTIVATION", "deviceSubType": "IPC", "creationDate": 1604731092000, "lastUpdateDate": 1609248229000, "lastUpdatedBy": 25804, "deviceAlarmStatus": "stop", "autoJoin": null, "battery": null, "ownnerId": null, "longitude": null, "latitude": null, "chatJid": null, "chatId": null, "liveChannelId": null, "userName": "张三_14776771015", "ownnerName": null } ], "pos": 0, "total_count": 2, "entityName": null }, "timestamp": "2020-12-30T10:59:40.883+0800" } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。 #### 错误码 错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。