# 功能详情
获取GB28181摄像头的预置位列表。
注意:该接口仅支持GB28181协议对接的摄像头。
# 请求地址和方法
- 请求地址
https://www.sdzhiot.top/api/v3/camera/preset/list
- 请求方法
GET
# 参数说明
- 请求头
Content-Type:application/json;charset=UTF-8
- 请求参数
| 字段名 | 字段类型 | 字段说明 | 是否必须 |
|---|---|---|---|
| serial | String | 设备序列号(国标ID) | Y |
| channel | String | 通道号(多通道类型设备需指定具体通道号) | N |
# 样例输入
/api/v3/camera/preset/list?serial=34020000001320000001&channel=34020000001320000002
# 返回data字段说明
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| items | Array | 预置位列表 |
items数组元素字段说明:
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| id | Integer | 预置位ID |
| name | String | 预置位名称 |
| token | String | 预置位token(ONVIF设备返回,国标设备为空字符串) |
# 样例输出
{
"code": 0,
"data": {
"items": [
{
"id": 1,
"name": "点位1",
"token": ""
},
{
"id": 2,
"name": "点位2",
"token": ""
},
{
"id": 3,
"name": "点位3",
"token": ""
}
]
},
"msg": "操作成功"
}
# 返回码
| 返回码 | 返回消息 | 说明 |
|---|---|---|
| 0 | 操作成功 | 请求成功 |
| 500 | 服务器错误 | 服务端异常 |
| 10001 | 参数为空或格式不正确 | 参数错误 |
| 10002 | appKey不存在 | 确认appKey是否正确 |
| 10004 | 签名错误 | 参数签名错误 |