# 摄像头信息查询（好望云平台）（API名称：getDeviceInfo）
#### 功能介绍
用于与客户系统对接摄像头信息查询（好望云平台）。
#### 相关API
| **接口名称**                                                             | **调用说明**                                                                                            |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。                                        |
| [获取设备列表](https://support.huaweicloud.com/api-isdp/api_01_0135.html)  | 调用该接口获取到isdp唯一设备ID。 获取设备信息时，需要输入isdp唯一设备ID。 |
| [添加设备](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_0000002522854539.png "点击放大")
#### URL
| **请求方式** | **HTTPS地址**                                        | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/ivm/getDeviceInfo | 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的值 |
   
#### 请求参数
| **参数**       | **类型** | **是否必填** | **描述**                                                                                                                                                                                      |
|:---|:---|:---|:---|
| isdpDeviceId | String | 是        | isdp唯一设备ID 获取isdp唯一设备ID API请参见：[摄像头列表查询（好望云平台）（API名称：getDeviceList）](https://support.huaweicloud.com/api-isdp/api_01_0135.html) |
   
#### 响应参数
| **参数**              | **类型** | **描述**     |
|:---|:---|:---|
| 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播放地址    |
   
#### 请求示例
```
{
    "isdpDeviceId":"21024125389SL7002176-0"
}
```
#### 响应示例
```
{
    "status": 1,
    "message": "SUCCESS",
    "error": null,
    "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": "XXXXXXXX基站",
        "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.xxxxxx.com/live/work003?app=vis&stream=XXXX",
        "verificationCode": "6h6yM3U1",
        "deviceManageState": "ACTIVATION",
        "deviceSubType": "IPC-CONCH",
        "creationDate": 1608968667000,
        "lastUpdateDate": 1609298831000,
        "lastUpdatedBy": null,
        "deviceAlarmStatus": "pulse",
        "autoJoin": null,
        "battery": null,
        "ownnerId": null,
        "longitude": null,
        "latitude": null,
        "chatJid": null,
        "chatId": null,
        "liveChannelId": null,
        "userName": null,
        "ownnerName": null
    },
    "timestamp": "2020-12-30T11:28:27.182+0800"
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。