设备信息列表查询(API名称:queryAll)
功能介绍
用于与客户系统对接查询设备列表。
相关接口
接口名称 |
调用说明 |
---|---|
调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
URL
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
---|---|---|---|
POST |
https://isdp+域名/openapi/v1/helmet/queryAll |
OpenAPI |
application/json |
请求头
KEY |
VALUE |
是否必填 |
描述 |
---|---|---|---|
Content-Type |
application/json |
是 |
无 |
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
参数 |
类型 |
是否必填 |
描述 |
---|---|---|---|
page |
Object |
否 |
分页参数 |
start |
Integer |
否 |
当前页码,分页参数,page子项 |
count |
Integer |
否 |
每页条数,分页参数,page子项 |
deviceId |
String |
否 |
设备编码 |
isdpDeviceId |
String |
否 |
设备唯一键 多个通过英文逗号分隔,最多200个 |
deviceName |
String |
否 |
设备名称 |
coordType |
String |
否 |
坐标系类型 可选值WGS84或GCJ02或BD09,不填默认WGS84 |
projectName |
String |
否 |
项目名称 |
projectNumber |
String |
否 |
项目编码 |
groupId |
Long |
否 |
群组Id |
groupName |
String |
否 |
群组名称 |
deviceUserId |
Long |
否 |
设备使用Id |
deviceUserName |
String |
否 |
设备使用人名称 |
ownnerName |
String |
否 |
设备责任人名称 |
deviceType |
String |
否 |
设备类型 可选值WEBCAM/MONITOR_BALL/BODY_WORN_CAMERA/INTELLIGENT_SAFETY_HELMET/INTELLIGENT_MINER_L IGHT/MOBILE/IVS1800/IVS3800 多个以英文逗号分隔,不传默认查询所有 |
deviceState |
String |
否 |
设备状态 可选值ONLINE/OFFLINE/UNALLOCATED/MEETING/MULTI_MEETING 多个以英文逗号分隔,不传默认查询所有 |
orgId |
Long |
否 |
组织Id |
响应参数
参数 |
类型 |
描述 |
---|---|---|
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播放地址 |
bindStatus |
Integer |
设备绑定状态 |
bindUserId |
Long |
设备绑定的用户Id |
buOrgId |
Long |
设备所在组织Id |
buOrgName |
String |
设备所在组织名称 |
coordType |
String |
坐标类型 |
creationDate |
Date |
创建时间 |
deviceManageState |
String |
设备管理状态 |
deviceStateBefore |
String |
设备上报之前的状态 |
deviceTypeName |
String |
设备类型名称 |
deviceUserId |
Long |
设备使用人Id |
deviceUserName |
String |
设备使用人名称 |
deviceUserNameOnly |
String |
设备使用人名称 |
enableEndSide |
String |
是否开启边缘AI |
enableVideoRecording |
String |
是否开启录像 |
groupId |
Long |
群组Id |
groupName |
String |
群组名称 |
integrationPlatform |
String |
集成平台 |
lastReportTime |
Date |
最后一次上报时间 |
lastUpdateDate |
Date |
最后更新时间 (时间戳) |
lastUpdatedBy |
Long |
最后更新人(时间戳) |
onlineDuration |
Long |
设备在线时长 |
stateChangeReason |
String |
设备状态改变原因 |
stateChangeReasonCode |
String |
设备状态改变原因码 |
storageRemain |
Long |
存储保留 |
storageTotal |
Long |
存储总计 |
tenantId |
Long |
租户Id |
请求示例
{ "deviceId" : "", "deviceName" : "", "deviceType" : "", "projectNumber" : "", "projectName" : "", "deviceState" : "ONLINE,MEETING", "page" : { "count" : 500, "start" : 0 }, "coordType" : "BD09" }
响应示例
{ "status" : 1, "message" : "SUCCESS", "error" : null, "data" : { "data" : [{ "deviceId" : "05238798080487120101", "isdpDeviceId" : "05238798080487120101", "channelId" : "-1", "deviceName" : "HoloSensSDC", "deviceState" : "MEETING", "accessProtocol" : null, "projectNumber" : "defaultProject", "projectName" : "默认项目", "deviceType" : "WEBCAM", "deviceSystemState" : null, "description" : null, "model" : null, "manufacture" : "HUAWEI", "channelTotal" : 0, "streamTotal" : 0, "firmware" : null, "deviceAbility" : null, "mac" : null, "createTime" : null, "updateTime" : null, "protocolVersion" : null, "deviceIp" : null, "devicePort" : null, "tenantId" : 886, "deviceAddress" : null, "fileId" : null, "sysType" : null, "fileSize" : null, "fileName" : null, "fileExt" : null, "deviceAddressNumber" : null, "webPlayUrl" : null, "deviceManageState" : "ACTIVATION", "deviceSubType" : "IPC", "creationDate" : 1661848660000, "lastUpdateDate" : 1661848660000, "lastUpdatedBy" : 1, "deviceAlarmStatus" : null, "autoJoin" : null, "battery" : null, "ownnerId" : null, "longitude" : null, "latitude" : null, "buOrgId" : 1409142, "buOrgName" : "广东省", "coordType" : null, "chatJid" : null, "chatId" : null, "liveChannelId" : "320042737078341", "deviceUserId" : null, "groupId" : null, "groupName" : null, "bindStatus" : null, "bindUserId" : null, "storageTotal" : null, "storageRemain" : null, "onlineDuration" : null, "enableEndSide" : null, "enableVideoRecording" : null, "lastReportTime" : null, "integrationPlatform" : "IVS3800", "stateChangeReason" : null, "stateChangeReasonCode" : null, "deviceStateBefore" : null, "userName" : null, "ownnerName" : null, "deviceUserName" : null, "deviceUserNameOnly" : null, "deviceTypeName" : "摄像头" } ], "pos" : 0, "total_count" : 1, "entityName" : null, "totalCount" : 1 }, "timestamp" : "2022-09-06T16:55:34.097+0800" }
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。