onenet接入方案與restfulapi接口歡迎訪問設(shè)備云門戶網(wǎng)站注冊用戶

歡迎設(shè)備云門戶 RESTAPI增加歷史數(shù)據(jù)查詢接口，用于上報數(shù)據(jù)點，1、修改3.5.3 AB接口，增加獲取每個數(shù)據(jù)流當(dāng)前OneNet接入方案與RESTfulAPI接 概 API資源模 REST 設(shè)計原 HTTP原始報文格 設(shè)備 新 更 查 刪 數(shù)據(jù)流 新 更 查 刪 數(shù)據(jù)點 新 更 查 刪 觸發(fā)器 新 更 查 刪 API權(quán)限 新 更 查 刪 新 查 刪 命令執(zhí)行 發(fā)送命 查看狀 獲取響 其 OneNet是中移物聯(lián)網(wǎng)基于物聯(lián)網(wǎng)技術(shù)和產(chǎn)業(yè)特點打造的開放平臺和生態(tài)環(huán)境，API和部署成本，滿足物聯(lián)網(wǎng)領(lǐng)域設(shè)備連接、協(xié)議適配、數(shù)據(jù)、數(shù)據(jù)安全、大數(shù)據(jù)分析等平重點行業(yè)領(lǐng)域/大客戶提供行業(yè)PaaS服務(wù)和定制化開發(fā)服務(wù)。若需要實時接收業(yè)務(wù)層下發(fā)的控制命令，需要保持EDP長連接。業(yè)務(wù)OneNet業(yè)務(wù)OneNetRestFUL接EDP承載業(yè)務(wù)數(shù)據(jù)和EDPEDPAPItt idid、時間等信息，value部分可以為任何數(shù)據(jù)對象，如整數(shù)、字符串或者JSON數(shù)據(jù)類型。APIKey用于對設(shè)備云進(jìn)行操作的權(quán)限控制，在OneNetRestAPI時，http請求消息 上項目時會生成一個默認(rèn)的APIKey，這個APIKey是masterkey，具有對本項目下所有設(shè)備最大的權(quán)限。除了這個masterkey之外，還可以通過API命令創(chuàng)建具備不同權(quán)限的其他APIKeyAPIKey的權(quán)限模型是通過設(shè)定對某些設(shè)備和命令是讓設(shè)備云主動給設(shè)備推送數(shù)據(jù)的式。默認(rèn)只有EDP設(shè)備或者M(jìn)ODBUS設(shè)上。二進(jìn)制數(shù)據(jù)主要是等等。數(shù)據(jù)流 數(shù)據(jù)流數(shù)據(jù)流 數(shù)據(jù)流RESTRESTAPI基于HTTP（詳見和 端口80或 TURL參數(shù)中涉設(shè)備云下發(fā)的日期時間格式為--:”，中間用空格隔開，與上行格設(shè)計原HTTPHTTPBadHTTPbody中以jsonNot{"errno":Not}Not成功、失敗指示，主要以InternalServerNoserverHTTP Content-Length: Content-Length: 設(shè)備新HTTPHTTPHTTPHTTPHTTP{//設(shè)備//設(shè)備位"location":{////高度//經(jīng)度//緯度//本設(shè)備是否私有，公開的應(yīng)用 上發(fā)現(xiàn)上會列出//可選對于MODBUS設(shè)備有效，需包含（phone）和（svrpwd）形式為{“登錄報文的phone字段”:”登錄報文的SVRPWD字段//可選，對modbus設(shè)備有效，TCP類設(shè)備，表示設(shè)備云主動查詢設(shè)備的時間間}HTTP響應(yīng)響{"errno":0,{//平臺分配唯一}}1MODBUSEDPauth_infointerval更HTTPHTTPHTTP{"title":"mydevice1",,//}{"errno":}2、Private字段表示是否私有。私有的設(shè)備不會列在” 3、auth_info和interval字段參見設(shè)備新增章節(jié)的解釋。查a查看單個設(shè)備的信ID的情況下查看設(shè)備的明細(xì)。會返回待查設(shè)備的基本信息、所有數(shù)據(jù)流信息、apikey信息、二進(jìn)制數(shù)據(jù)信息等等。HTTPHTTP{"errno":0,{//表示EDP設(shè)備是否，只對EDP設(shè)備存在此字"desc":"somedescription,ex:url",//設(shè)備關(guān)聯(lián)的圖像或二//二進(jìn)制數(shù)據(jù) //上傳時//二進(jìn)制數(shù)據(jù)//MODBUSEDP設(shè)備有//數(shù)據(jù)}//end}但是http://<API_ADDRESS>/devices/<device_id>/會查詢不到。具體如下請 響{{[{{{}}b模糊批量查找通過在URL中附帶參數(shù)的形式向服務(wù)器端查詢設(shè)備。HTTP URL=tagxxxonline=true|false//可選privatetrue|false可選page //指定頁碼,HTTP{"errno":0,{[{"title":"mydevice1","create_time":"2013-02-1112:22:33",}]}}刪HTTPHTTPHTTP無{"errno":}數(shù)據(jù)流新HTTPHTTPHTTP{//只有MODBUS設(shè)備填寫，MODBUS命令，16進(jìn)制字節(jié)字//只有MODBUS設(shè)備填寫，間隔，//只有MODBUS設(shè)備填寫，最終結(jié)果處理方法，寄存器地址從A0開始,多個}{"errno":0,{}}更 HTTPHTTPHTTP{}{"errno":}。查HTTPHTTP{"errno"://數(shù)據(jù)流{//設(shè)備范圍內(nèi)//平臺范圍內(nèi)"create_time":"xxxx-xx-xx10:22:22",}}HTTPURL 表示查看tempgpsHTTP{"errno":} 刪HTTPHTTPHTTP無{"errno":}數(shù)據(jù)點暫不提供更新操作的API新HTTPHTTPHTTP{{{//參數(shù)可]{]]}{"errno":}temperaturekeytemperature數(shù)據(jù)流有兩個數(shù)據(jù)點，key數(shù)據(jù)流也有兩個數(shù)據(jù)點。4.4.1API創(chuàng)建本數(shù)據(jù)at表示時間，為可選字段。如果為valueJSON對象，可以為整型、字符串多種類型。at部分取空，設(shè)備云會取系統(tǒng)時間，精度為毫秒，如果在一條命令所使用的簡寫方式。目前type支持3，4，5三種情況temperature20152222231其中，每個field格式支持3種，下面以逗號作為域中分隔符進(jìn)行說明：field31ID和時間戳，只傳輸數(shù)據(jù)值，平臺將用該域所在的位置號（從0開始）作為數(shù)據(jù)流ID。通用格式：{{{{}}{{}}}{{}}]}更查GPS型數(shù)據(jù)格式（value二進(jìn)制數(shù)據(jù)數(shù)據(jù)索引格式（value “index”:”FW3SO72FZIF3W”,“size”:2333(字節(jié) desc參數(shù)確定HTTPURL5.cursor:指定本次請求繼續(xù)從cursor位置開始提取數(shù)據(jù)HTTP{"errno":{{//數(shù)據(jù)流統(tǒng)計//求最值時返回的一個最值時間點"at":"xxxx-xx-xx10:22:22",}{]}} /devices/564280/datapoints表示查詢設(shè)備id為564280對應(yīng)的所 /devices/564280/datapoints?limit=10，假設(shè)說設(shè)備564280有三個數(shù)據(jù)流，那么這三個流中每個流都會最多返回10個數(shù)據(jù)點。要查看某一條數(shù)據(jù)流數(shù)據(jù)，在上述URL中增加參數(shù)datastream_id，如下所示： 用http: /devices/564280/datapoints?datastream_id=溫度2&limit=10會返回數(shù)據(jù)流”溫度2”中最近的10個數(shù)據(jù)點。要查看某一條數(shù)據(jù)流在某個時間范圍內(nèi)的數(shù)據(jù)，可以在增加start和end參數(shù)。 2013512171233172233秒的數(shù)據(jù)點。注意如果start參數(shù)存在，end參數(shù)不存在，表示取start后的所有數(shù)據(jù)；start不存在，endend參數(shù)。注意：日期時間格式格式必須2013-05-12T17:12:33T分隔。start和end之間的時間間隔最大為1年，超過一年會忽略。start100limit限定的數(shù)目時，返回的jsoncursor字段，下一次請求令行中可以攜帶此cursor字段表示接著遍歷本數(shù)據(jù)流。此cursor字段標(biāo)識method參數(shù)用于只有當(dāng)數(shù)據(jù)流的value為整數(shù)時有效。如果為字符串或者其他類型，sum/avg/min/max，當(dāng)指定此參數(shù)時，返回的結(jié)果在響應(yīng)的json字符串中的statistic部分，否則沒有statistic部分.請求 ?請求 ?度{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01請求 ?度{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01請求 datastream_id=溫度{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01{"at":"2015-12-01刪觸發(fā)器新HTTPHTTPMasterHTTP{//"title":"wendujian//可選，數(shù)據(jù)流名稱//可選，設(shè)備//可選，數(shù)據(jù)流uuid //type不同，見以下說明}typeinout時，threshold設(shè)置為{“l(fā)olmt”:40,“uplmt”:52}，表示數(shù)據(jù)流的流的當(dāng)前值，$val[1]為第二個…。例如，第一個數(shù)據(jù)流上報數(shù)據(jù)點格式為：threshold中條件表達(dá)式可設(shè)置為：“$val[0][‘temperature’]>30$val[0][‘humidity’]<33type為change時，thresholdtypefrozen時，threshold為數(shù)值，指定多少秒內(nèi)未上報數(shù)據(jù)觸發(fā)告警，同時被對象進(jìn)入frozen狀態(tài)。{"errno":{}}中數(shù)據(jù)流名稱符合ds_id的數(shù)據(jù)都會進(jìn)入觸發(fā)判斷邏輯；ds_uuids數(shù)組，那么只有這些指定的數(shù)據(jù)流會進(jìn)入觸發(fā)判斷更HTTPHTTPHTTP{"title":"wendujiankong","datastream1_uuid”,"datastream2_uuid”, }注：若要修改觸發(fā)條件，必須同時設(shè)置type和{"errno":}查AHTTPHTTP{"errno":"title":"wendujiankong","datastream1_uuid”,"datastream2_uuid”, //觸發(fā)器是否已失效}}bHTTPURLtitle=name//指定觸發(fā)器名page //指定頁碼,per_page=10//指定每頁輸出個數(shù),可選,默認(rèn)10，最多HTTP{"errno":"title":"wendujiankong", //觸發(fā)器是否已失效}}刪HTTPHTTPHTTP無{"errno":}API權(quán)限新HTTPHTTPHTTP{{{}]["get",]}]}{"errno":0,{}}更HTTPHTTPHTTP{{//被的資{//數(shù)據(jù)流id，可//被令，可選。如果沒有，表示可以進(jìn)行任何操}{"errno":}說明：對于masterkey不允許更新操作，masterkey默認(rèn)具有最大權(quán)限，可以該用戶名下所有設(shè)備、所有數(shù)據(jù)，可以進(jìn)行POST、GET、PUT、DELETEmasterkey系查HTTPURLpage //指定頁碼,=HTTP{"data":"keys":[{"create_time":"2015-11-0414:25:52","title":"Auto-generated-master-key",{"create_time":"2015-12-0310:00:41","permissions":[{{}]}}"page":}刪HTTPHTTPHTTP無{"errno":}二進(jìn)制數(shù)據(jù)新HTTPHTTPURLHTTP{"errno":0,//該數(shù)據(jù)在設(shè)備云的索}}查功能：二進(jìn)制數(shù)據(jù)的內(nèi)容。若查詢沒有該數(shù)據(jù)返回 HTTPHTTPURLHTTP刪命令執(zhí)行發(fā)送命令HTTPHTTPURLHTTP{"errno"://不超過64個字符}