Query device details
Request format: GET
URL: http://api.onenet.hk.chinamobile.com/devices/device_id
device_id: to be replaced with device ID
Return Parameters
Parameter Name |
Format |
Description |
errno |
int |
Call error code, where 0 means success. |
error |
string |
Error description. “succ” means the call is successful. |
data |
json |
Device-related information returned after interface is successfully called. See the Data Description Table. |
Data Description Table
Parameter Name |
Format |
Description |
protocol |
string |
Device access protocol |
create_time |
string |
Device creation time, Beijing time |
online |
bool |
Device online status |
id |
string |
Device ID |
auth_info |
string |
Device authentication information, corresponding to the “sn” or “mac” parameter in the device registration interface |
title |
string |
Device name |
desc |
string |
Device description |
tags |
array- string |
Device tag |
location |
json |
Coordinates of the device location, expressed as a longitude and latitude key-value pair: {“lon”:xx, “lat”:xx} |
other |
json |
Other custom information of the device, in the key-value pair format. See the example. |
datastreams |
array- json |
json array of device data stream. See the datastreams description table. |
Datastreams Description Table
Parameter Name |
Format |
Description |
id |
string |
Data stream name |
create_time |
string |
Data stream creation time, Beijing time |
unit |
string |
Unit |
unit_symbol |
string |
Unit symbol |
Return Example
{
"errno": 0,
"data": {
"protocol": "DTU",
"other": {
"version": "1.0.0",
"manufacturer": "china mobile"
},
"create_time": "2018-07-04 17:43:11",
"online": false,
"location": {
"lat": 23.54,
"lon": 109
},
"id": "35282992",
"auth_info": "tes01235n82105",
"datastreams": [{
"unit": "",
"id": "1",
"unit_symbol": "",
"create_time": "2018-07-04 17:43:11"
}],
"title": "test_device",
"desc": "test_desc",
"tags": ["china", "mobile"]
},
"error": "succ"
}