设备详情
最近更新时间：2026-03-30 09:58:43
接口说明
查询平台上已注册设备的详细信息

接口地址
https://iot-api.heclouds.com/device/detail

API 说明
请求方式：GET

httpquery 请求参数

参数名称	格式	是否必选	说明
product_id	string	产品 id+设备名称、imei 二选一必填	产品 ID
device_name	string	产品 id+设备名称、imei 二选一必填	设备名称
imei	string	产品 id+设备名称、imei 二选一必填	设备 imei(当设备来自于老平台下 NB 套件产品时，imei 必填，且 device_name 应当为空)
返回数据

参数名称	类型	描述
code	int	错误码，当为 0 时表示请求成功，取值见错误码说明表
msg	string	错误描述信息
request_id	string	API 请求链路 id
data	-	具体响应内容
data.did	int/string	设备 id
data.pid	string	产品 id
data.access_pt	int	接入协议，取值见接入协议取值说明表
data.data_pt	int	数据协议，取值见数据协议取值说明表
data.name	string	设备名称
data.desc	string	设备描述
data.auth_info	---	---
data.status	int	设备状态，0-离线，1-在线，2-未激活
data.create_time	datetime	设备创建时间
data.activate_time	datetime	设备激活时间
data.last_time	datetime	设备最后一次在线时间
data.sec_key	string	设备接入鉴权 key
data.imei	string	LwM2M 设备 imei
data.imsi	string	LwM2M 设备 imsi
data.psk	string	LwM2M 设备 psk
data.auth_code	string	LwM2M 设备 auth_code
data.intelligent_way	int	产品智能化方式，1-设备接入、2-产品智能化
data.group_id	string	设备分组 id
data.enable_status	bool	设备启用状态
data.tags	string-array	设备标签列表
data.lon	string	经度
data.lat	string	纬度
data.chip	---	---
data.obsv	bool	设备资源自动订阅是否启用
data.obsv_st	bool	设备资源自动订阅状态
data.private	bool	设备私密性
data.imsi_old	string-array	设备 imsi 历史变更记录
data.imsi_mt	datetime	设备 imsi 最近一次修改时间
视联网设备时返回以下字段
data.viot_device_sn	string	视频设备编码，视联网设备返回
data.viot_protocol	int	视频设备接入协议，视联网设备返回
1-GB28181 协议
2-千里眼协议
data.viot_device_type	int	视频设备设备类型，视联网设备返回
1-IPC
2-NVR
视联网国标协议设备时返回
data.viot_sip_server_id	string	SIP 服务器 ID，国标摄像头设备返回
data.viot_sip_server_domain	string	SIP 服务器域，国标摄像头设备返回
data.viot_sip_server_ip	string	SIP 服务器 IP，国标摄像头设备返回
data.viot_sip_server_port	string	SIP 服务器端口，国标摄像头设备返回
data.viot_login_name	string	登录用户名，国标摄像头设备返回
data.viot_login_pwd	string	登录密码，国标摄像头设备返回
视联网千里眼协议设备时返回
data.viot_module_id	string	设备 modelId，如：cmiot_E4702_002
data.viot_camera_app_version	string	软件版本，如：2.860.20250512
data.viot_firmware_version	string	固件版本，如：2.860.20250512
data.viot_imei	string	千里眼设备 imei（cmei），如：119094672043670
机卡协同设备上报数据,设备上报后返回
data.up_iccid	string	设备上报的iccid，如：898604310000000000
data.up_msisdn	string	设备上报的msisdn，如：+8613800000000
data.up_sn	string	设备上报的sn
data.up_imei	string	设备上报的imei，如：119094672043670
data.up_imsi	string	设备上报的imsi，如：460010000000000
data.up_mac	string	设备上报的mac，如：08:00:27:01:02:03
data.up_network	int	设备上报的网络类型，0-非蜂窝网, 1-移动，2-电信，3-联通，4-广电
示例
请求示例：

GET https://iot-api.heclouds.com/device/detail?product_id=123&device_name=dname
响应示例：

{
    "code": 0,
    "data": {
        "did": 2502614722,
        "pid": "FUSZT1w5t2",
        "access_pt": 51,
        "auth_info": "e02efee79b5a-pro",
        "data_pt": 3,
        "name": "e02efee79b5a-pro",
        "desc": "",
        "status": 1,
        "create_time": "2025-11-28T09:49:00.613+08:00",
        "activate_time": "2025-12-01T15:38:51.073+08:00",
        "last_time": "2025-12-01T15:38:51.073+08:00",
        "imsi": "",
        "imei": "",
        "psk": "",
        "group_id": "",
        "enable_status": true,
        "tags": [],
        "lat": "",
        "lon": "",
        "auth_code": "",
        "sec_key": "",
        "chip": 0,
        "obsv": false,
        "obsv_st": false,
        "private": false,
        "imsi_old": [],
        "imsi_mt": "0001-01-01T08:05:43+08:05",
        "intelligent_way": 1,
        "viot_device_sn": "e02efee79b5a",
        "viot_protocol": 2,
        "viot_device_type": 1,
        "viot_module_id": "cmiot_E4702_002",
        "viot_camera_app_version": "2.860.20250512",
        "viot_firmware_version": "2.860.20250512",
        "viot_imei": "119094672043670"
    },
    "msg": "succ",
    "request_id": "a3d0de892827437b9ad2aa9e6754fb40"
}