[NB-IoT物聯網套件] 產品介紹 快速入門 用戶指南 設備開發指南 應用開發指南 最佳實踐 常見問題 服務協議 變更日誌

查看數據點

請求方式:GET

URL: http(s)://api.onenet.hk.chinamobile.com/devices/{device_id}/datapoints

說明:device_id需要替換為設備ID

我只想看示例!!!

url參數

參數名稱格式是否必須說明
datastream_idstring數據流,多個數據流之間用逗號分隔
startstring提取數據點的開始時間,格式:2015-01-10T08:00:35
endstring提取數據點的結束時間,格式:2015-01-10T08:00:35
limitint限定本次請求最多返回的數據點的數量,取值>0,<=6000< td="">
cursorstring指定本次請求繼續從cursor位置開始提取數據

返回參數

參數名稱格式說明
errnoint調用錯誤碼,為0表示調用成功
error string錯誤描述,為"succ"表示調用成功
datajson介面調用成功之後返回的設備相關信息,見data描述表

data描述表

參數名稱格式說明
cursorstring下一個數據點的位置
datastreamsarray-json設備數據流信息的json陣列,見datastreams描述表
countint返回的數據流個數

datastreams描述表

參數名稱格式說明
idstring數據流名稱
datapointsarray-json數據點的json陣列,見datapoints描述表
statistic json數據流統計信息的json ,見stat st c描述表

datapoints描述表

參數名稱格式說明
atstring時間
valuestring/array數據點的值
statistic描述表
參數名稱格式說明
atstring求最值時返回的一個最值時間點
valuestring數據點的值

說明

  1. 不攜帶任何參數,直接調用,則返回本設備所存在的所有數據流中最新的數據。 如果這個設備有三個數據流,則返回這三個數據流中每個數據流中最後一條數據。
  2. 不攜帶數據流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。
  3. 要查看某一條數據流在某個時間範圍內的數據,可以在增加start和end參數。 注意如果start參數存在,end參數不存在,表示取start後的所有數據;如果start不存在,end存在,設備雲會忽略end參數。 start 和end之間的時間間隔最大為1年,超過一年會忽略。
  4. 如果指定了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"}

< 批量查詢設備最新數據

即時命令-讀設備資源 >

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “