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

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