查询视频设备详情
更新时间：2025-08-06
接口描述
查询视频设备详情。
请求结构
POST /console/api/v1/device/query_device_detail
请求头域
| 请求头名称 | 描述 | 示例 |
|---|---|---|
| Authorization | 认证头。登录响应返回的token内容，如果不填或者填错会拒绝请求 | Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyTmFtZSI6ImFkbWluIiwiZXhwIjoxNjY3NDc4OTc4fQ.JL9R7CqIhPFdQWZry4e9ONZntUTmNzBp0sDE05rMxl |
请求参数
| 参数 | 类型 | 是否必选 | 描述 | 示例 |
|---|---|---|---|---|
| deviceId | Int64 | 是 | 添加设备时返回的唯一标识ID | 23 |
响应头域
无特殊响应头。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int32 | 接口返回状态, 0表示成功，其他表示失败 |
| message | String | 成功或错误提示 |
| data | Map | 设备信息 |
| id | Int64 | 设备ID |
| deviceName | String | 设备名称 |
| status | String | 设备状态 |
| username | String | 设备RTSP访问用户名 |
| password | String | 设备RTSP访问密码 |
| dispatchAddr | String | 设备原始RTSP视频流地址，该RTSP地址可以直接访问，不需要密码 |
| deviceRtsp | String | 添加设备时输入的设备RTSP流地址 |
| position | String | 设备位置 |
| manufacturer | String | 设备厂商 |
| createAt | String | 创建时间 |
| aiElapse | Map | key是AI技能英文唯一标识，value是毫秒级整数的识别任务识别间隔设置 |
| videoRecord | Map | key是AI技能英文唯一标识，value是布尔类型，表示是否开启视频存证 |
| mergeList | Array | 经过视频分析的合成流数组。目前数组最多只有1项。 |
| +mergeId | Int64 | 合成流数据库记录主键ID |
| +url | String | 合成流RTSP地址 |
| +urlRtmp | String | 合成流RTMP地址 |
| +urlFlv | String | flv播放地址的http path部分。 比如/merge/32.flv |
| +aiList | Array | 该合成流包含的所有技能对象构成的数组 |
| ++value | String | 技能英文名称 |
| ++label | String | 技能中文名称 |
| aiParam | Array of JSON | 算法任务的参数配置信息。 |
| +name | String | 算法英文名称 |
| +param | JSON | 算法任务参数配置 |
| ++purpose | String | 参数组用途 |
| ++display | String | 参数组前端展示名称 |
| ++items | Array of JSON | 参数组包含的具体配置项 |
| +++purpose | String | 参数项用途 |
| +++display | String | 参数项前端展示名称 |
| +++value | Any | 参数项的值。不同前端组件的值类型不同。比如integer类型的项，值为整数;polygon类型的项，值为浮点数数组。 |
请求示例
Java
1POST /console/api/v1/device/query_device_detail
2Content-Type: application/json
3Content-Length: 1254
4Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyTmFtZSI6ImFkbWluIiwiZXhwIjoxNjY4NjgxODg5fQ.NkjiNOeMnzP9To-CuV4F9306OH1RY0xz69RG4dstTSk
5
6{
7 "deviceId":100
8}响应示例
Java
1HTTP/1.1 200 OK
2cache-control: no-cache
3content-length: 484
4content-type: application/json; charset=utf-8
5date: Thu, 17 Nov 2022 00:45:02 GMT
6server: nginx/1.21.6
7
8{
9 "status":0,
10 "message": "success",
11 "data"{
12 "id":100,
13 "deviceName": "device001",
14 "username": "testme",
15 "password": "pwd1",
16 "dispatchAddr": "rtsp://192.168.1.64:554/dispatch_1",
17 "deviceRtsp": "rtsp://192.168.1.64:554/channels/101",
18 "createAt": "2025-08-06 11:05:06",
19 "position": "大门口",
20 "manufacturer": "海康威视",
21 "aiElapse": {
22 "face2": 1500
23 },
24 "videoRecord": {
25 "face2": true
26 },
27 "mergeList": [
28 {
29 "mergeId":1000,
30 "url": "rtsp://192.168.1.64:8194/merge/1345",
31 "urlRtmp": "rtmp://192.168.1.64:8195/merge/1345",
32 "urlFlv": "/merge/1345.flv",
33 "aiList": [
34 {
35 "value": "face2",
36 "label": "人脸检测"
37 }
38 ],
39 "aiParam": [ // 返回已经设置的算法参数配置,如果某个算法没有设置，会默认设置一个空的aiParam.param，以便前端方便处理。
40 {
41 "name": "wash-hand-detect",
42 "param": [
43 {
44 "purpose": "filterRegion",
45 "display": "客户自己设置的描述1",
46 "items": [
47 {
48 "purpose": "filterPolygon",
49 "display": "客户自己设置的描述1.1",
50 "value": {
51 "polygon": [
52 0.13,
53 0.14,
54 0.85,
55 0.17,
56 0.89,
57 0.802
58 ],
59 "text": "区域1"
60 }
61 }
62 ]
63 },
64 {
65 "purpose": "confidence",
66 "display": "客户自己设置的描述2",
67 "items": [
68 {
69 "purpose": "confidence",
70 "display": "客户自己设置的描述2.1",
71 "value": 85
72 }
73 ]
74 }
75 ]
76 }
77 ]
78 }
79}