设备列表
最近更新时间：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"
}
