查看數據點
請求方式:GET
URL: http(s)://api.onenet.hk.chinamobile.com/devices/{device_id}/datapoints
說明:device_id需要替換為設備ID
我只想看示例!!!
url參數
參數名稱 | 格式 | 是否必須 | 說明 |
datastream_id | string | 否 | 數據流,多個數據流之間用逗號分隔 |
start | string | 否 | 提取數據點的開始時間,格式:2015-01-10T08:00:35 |
end | string | 否 | 提取數據點的結束時間,格式:2015-01-10T08:00:35 |
limit | int | 否 | 限定本次請求最多返回的數據點的數量,取值>0,<=6000< td="">=6000<> |
cursor | string | 否 | 指定本次請求繼續從cursor位置開始提取數據 |
返回參數
參數名稱 | 格式 | 說明 |
errno | int | 調用錯誤碼,為0表示調用成功 |
error | string | 錯誤描述,為"succ"表示調用成功 |
data | json | 介面調用成功之後返回的設備相關信息,見data描述表 |
data描述表
參數名稱 | 格式 | 說明 |
cursor | string | 下一個數據點的位置 |
datastreams | array-json | 設備數據流信息的json陣列,見datastreams描述表 |
count | int | 返回的數據流個數 |
datastreams描述表
參數名稱 | 格式 | 說明 |
id | string | 數據流名稱 |
datapoints | array-json | 數據點的json陣列,見datapoints描述表 |
statistic | json | 數據流統計信息的json ,見stat st c描述表 |
datapoints描述表
參數名稱 | 格式 | 說明 |
at | string | 時間 |
value | string/array | 數據點的值 |
statistic描述表
參數名稱 | 格式 | 說明 |
at | string | 求最值時返回的一個最值時間點 |
value | string | 數據點的值 |
說明
- 不攜帶任何參數,直接調用,則返回本設備所存在的所有數據流中最新的數據。 如果這個設備有三個數據流,則返回這三個數據流中每個數據流中最後一條數據。
- 不攜帶數據流id參數,攜帶limit參數時,會返回該設備每個數據流最多limit條數據。 其中datastreamid等於obj_id_obj_inst_id res_id,如obj_id 3200,obj_inst_id 0,res_id 5501,那麼這個datastream_id 就為3200_0_5501。
- 要查看某一條數據流在某個時間範圍內的數據,可以在增加start和end參數。 注意如果start參數存在,end參數不存在,表示取start後的所有數據;如果start不存在,end存在,設備雲會忽略end參數。 start 和end之間的時間間隔最大為1年,超過一年會忽略。
- 如果指定了start參數,則可能返回的數據點的數H會很多,此時默認會返回最多100個數據點。 可以使用limit參數,設定返回多少個數據點,最大為6000個數據點。 當實際的數據點數H多於limit限定的數H 時,返回的json串中會有一個cursor欄位,下一次請求的命令列中可以攜帶此cursor欄位表示接著遍歷本數據流。 此cursor欄位標識上次取出數據點後下一個數據點的位置。
請求示例
GET http://api.onenet.hk.chinamobile.com/devices/564280/datapoints? datastream_id=3200_0_5501&start=2015-11-30T17:12:33&end=2015-12-01T17:22:33&limit=5&cursor=25971_564280_1448961024981 HTTP/1.1
api-key: WhI*************v1c=
返回示例
{
"errno":0,
"data":{
"cursor":"25971_564280_1448961152173",
"count":5,
"datastreams":[
{
"datapoints":[
{
"at":"2015-12-01 17:10:24.981",
"value":"35"
},
{
"at":"2015-12-01 17:10:53.406",
"value":"38"
},
...
],
"id":"3200_0_5501"
},
...
]
},
"error":"succ"}