获取探测结果
更新时间：2021-10-08
接口描述
本接口用于获取ONVIF设备探测结果，从发起探测到获取到结果最长时间为5秒。
请求（Request）
请求URI
GET /v1/device/onvif/probeResult?deviceIp={deviceIp}
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| deviceIp | String | 是 | 设备ip或网段，ip格式如：119.249.51.196，网段格式如：119.249.51.196/25 |
请求头域
除公共头域外，无其它特殊头域。
请求体
无
响应（Response）
响应头域
除公共头域外，无其它特殊头域。
响应体
| 参数名称 | 类型 | 描述 |
|---|---|---|
| probeResultList | Array | 探测结果 |
| deviceIp | String | 设备ip |
| devicePort | Integer | 设备端口号 |
| type | String | 设备类型，ONVIF |
| manufacturer | String | 设备厂商 |
| platform | String | 设备类型，IPC/NVR |
| hardware | String | 设备型号 |
| created | Boolean | 是否已经添加过 |
示例
请求示例
GET /v1/device/onvif/probeResult?deviceIp=119.249.51.196/25 HTTP/1.1
x-bce-date: 2020-03-25T09:28:13Z
host: evs.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 202 013:34:07 GMT
Content-Type: application/json;charset=UTF-8
{
"probeResultList": [
{
"deviceIp": "119.249.51.196",
"devicePort": 8883,
"manufacturer": "IP-Camera",
"hardware": "HI3518C",
"type": "ONVIF",
"platform": "IPC",
"created": false
}
]
}错误码
| 错误码（code） | 消息（message) | 描述 | HTTP状态码 |
|---|---|---|---|
| ProbeTimeOut | probe time out, device ip : XXX | 探测超时 | 408 |
| ProbeResultNotExist | probe result not exist, device ip : XXX | 探测结果还未返回 | 404 |