103 lines
3.5 KiB
Plaintext
103 lines
3.5 KiB
Plaintext
设备列表
|
|
最近更新时间：2025-12-22 10:38:50
|
|
接口说明
|
|
用于查询产品下的设备列表，支持通过设备名称左前缀模糊匹配。
|
|
|
|
接口地址
|
|
https://iot-api.heclouds.com/device/list
|
|
|
|
API说明
|
|
请求方式：GET
|
|
|
|
http query 请求参数
|
|
|
|
参数名称 格式 是否必选 说明
|
|
product_id string 是 产品ID
|
|
device_name string 否 设备名称(左前缀模糊匹配)
|
|
offset int 否 查询起始下标，默认为0
|
|
limit int 否 单次查询数量限额，默认为10，最大为100
|
|
返回数据
|
|
|
|
参数名称 类型 描述
|
|
code int 错误码，当为0时表示请求成功，取值见错误码说明表
|
|
msg string 错误描述信息
|
|
request_id string API请求链路id
|
|
data - 具体响应内容
|
|
data.list[0].did int/string 设备id
|
|
data.list[0].pid string 产品id
|
|
data.list[0].access_pt int 接入协议，取值见接入协议取值说明表
|
|
data.list[0].data_pt int 数据协议，取值见数据协议取值说明表
|
|
data.list[0].name string 设备名称
|
|
data.list[0].desc string 设备描述
|
|
data.list[0].status int 设备状态，0-离线，1-在线，2-未激活
|
|
data.list[0].create_time datetime 设备创建时间
|
|
data.list[0].activate_time datetime 设备激活时间
|
|
data.list[0].last_time datetime 设备最后一次在线时间
|
|
data.list[0].sec_key string 设备接入鉴权key
|
|
data.list[0].imei string LwM2M设备imei
|
|
data.list[0].imsi string LwM2M设备imsi
|
|
data.list[0].psk string LwM2M设备psk
|
|
data.list[0].auth_code string LwM2M设备auth_code
|
|
data.list[0].intelligent_way int 产品智能化方式，1-设备接入、2-产品智能化
|
|
data.list[0].group_id string 设备分组id
|
|
data.list[0].enable_status bool 设备启用状态
|
|
data.list[0].lon string 经度
|
|
data.list[0].lat string 纬度
|
|
data.list[0].obsv bool 设备资源自动订阅是否启用
|
|
data.list[0].obsv_st bool 设备资源自动订阅状态
|
|
data.list[0].private bool 设备私密性
|
|
data.list[0].imsi_old string-array 设备imsi历史变更记录
|
|
data.list[0].imsi_mt datetime 设备imsi最近一次修改时间
|
|
data.list[0].viot_device_sn string 移动视联网设备返回唯一标识
|
|
data.list[0].viot_protocol int 移动视联网设备返回接入协议
|
|
1-GB28181协议
|
|
2-千里眼协议
|
|
data.offset int 查询起始下标
|
|
data.limit int 单次查询数量限额
|
|
示例
|
|
请求示例：
|
|
|
|
GET https://iot-api.heclouds.com/device/list?product_id=43770&device_name=&offset=0&limit=10
|
|
响应示例：
|
|
|
|
{
|
|
"code": 0,
|
|
"data":{
|
|
"list":[{
|
|
"did": 500006387,
|
|
"pid": "43770",
|
|
"access_pt": 4, //2-MQTT,4-LwM2M
|
|
"data_pt": 2,
|
|
"name": "nb4",
|
|
"desc": "",
|
|
"auth_info": {
|
|
"177393918128741": "222222"
|
|
},
|
|
"status": 2,//0-离线；1-在线；2-未激活
|
|
"create_time": "2022-07-13T09:19:53.873+08:00",
|
|
"activate_time": "0001-01-01T08:00:00+08:00",
|
|
"last_connect_time": "0001-01-01T00:00:00Z",
|
|
"imsi": "222222",
|
|
"imei": "177393918128741",
|
|
"psk": "BpLnfgDsc3WD9F3q",
|
|
"group_id": "",
|
|
"enable_status": true,
|
|
"Lat": "29.500816495765097",
|
|
"Lon": "106.69984891483458",
|
|
"auth_code": "",
|
|
"sec_key": "TmZISzZhOTVqakprd3pEa2gwaDNmaGZVVnVTMGpaOXU=",
|
|
"chip": 0,
|
|
"obsv": true,
|
|
"obsv_st": false,
|
|
"private": false,
|
|
"imsi_old": [],
|
|
"imsi_mt": "0001-01-01T08:00:00+08:00",
|
|
"intelligent_way": 1
|
|
}],
|
|
"limit":10,
|
|
"offset":0
|
|
}
|
|
"msg": "succ",
|
|
"requestId": "a25087f46dfddb69b29e90ef0acfd115"
|
|
}
|