查询设备详情
请求方式:GET
URL: http(s)://api.heclouds.com/devices/device_id
说明:device_id的值需要替换为设备ID。
我只想看示例!!!
返回参数
参数名称 | 格式 | 说明 |
errno | int | 调用错误码,为0表示调用成功 |
error | string | 错误描述,为"succ"表示调用成功 |
data | json | 接口调用成功之后返回的设备相关信息,见data描述表 |
data描述表
参数名称 | 格式 | 说明 |
id | string | 平台分配的唯一ID |
online | bool | 表示LwM2M设备是否在线 |
protocol | string | 设备接入协议(LwM2M) |
title | string | 设备名称 |
desc | string | 设备描述 |
create_time | string | 设备创建时间,北京时间 |
obsv | bool | 是否自动订阅 |
private | bool | 设备私密性 |
binary | json | 设备关联的图像或者二进制数据,详情见binary描述表 |
tags | array-string | 设备标签 |
observ_status | bool | 订阅状态,表示:设备上线后,平台下发订阅命令,设备资源是否全部成功 |
location | json | 设备位置坐标信息,以经纬度键值对表示:{"lon":xx,"lat":xx} |
auth_info | string | 设备鉴权信息,对应设备注册接口中的"sn"或者"mac"参数 |
other | json | 其他设备自定义信息,以键值对格式表示,见示例 |
datastreams | array-json | 设备数据流信息的json数组,见datastreams描述表 |
binary描述表
参数名称 | 格式 | 说明 |
index | string | 二进制数据索引 |
at | string | 上传时间 |
size | int | 字节 |
desc | string | 描述 |
datastreams描述表
参数名称 | 格式 | 说明 |
id | string | 数据流名称 |
create_time | string | 数据流创建时间,北京时间 |
unit | string | 单位 |
unit_symbol | string | 单位符号 |
请求示例
GET http://api.heclouds.com/devices/35****92 HTTP/1.1 //35****92为平台随机分配的设备ID
api-key: WhI*************v1c= //必须为 MasterKey, 由于涉及个人隐私,这里用“*******” 代替
返回示例
{
"errno": 0,
"data": {
"private": false,
"create_time": "2019-04-24 14:54:29",
"act_time": "Fri May 10 01:32:48 CST 2019",
"obsv": true,
"ack": false,
"auth_info": {
"188xxxxxxxx": "1xxxxxx4"
},
"imsi": "188832xxxx234",
"last_ct": "Fri Jun 21 17:06:32 CST 2019",
"title": "11",
"tags": [],
"obsv_st": false,
"protocol": "LwM2M",
"rg_id": "188832963901234",
"imsi_old": [
"188832963901234"
],
"imsi_mt": "Fri May 10 01:32:48 CST 2019",
"online": false,
"location": {
"lat": 0,
"lon": 0
},
"id": "524166559",
"datastreams":
[
{
"create_time": "2019-05-10 01:32:51",
"uuid": "d2fd9428-45f3-45f9-bd17-7106432f22dd",
"id": "9999_0_7"
},
],
"desc": ""
},
"error": "succ"
}