查看单个设备
请求方式:GET
URL: http://API_ADDRESS/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_ADDRESS/devices/35****92 HTTP/1.1
api-key: WhI*************v1c=
Host: API_ADDRESS
返回示例
{
"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"
}