查看单个设备
请求方式:GET
URL: http://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
api-key: WhI*************v1c=
Host: api.heclouds.com
返回示例
{
"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"
}