查询设备详情
請求方式:GET
URL: http(s)://api.onenet.hk.chinamobile.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.onenet.hk.chinamobile.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"
}