2024物聯(lián)網(wǎng)IOT平臺開放接口接入規(guī)范

物聯(lián)網(wǎng)IOT物聯(lián)網(wǎng)IOT本標(biāo)準(zhǔn)適用于建設(shè)和運(yùn)營的物聯(lián)網(wǎng)IOT平臺，及接入平臺的企事業(yè)單位。接入物聯(lián)網(wǎng)IOTGB/T32400：2015IETFRFC793：1981TransmissionControlProtocolDARPAInternetProgramProtocolSpecificationPartofStd7GB/T32400要了解底層技術(shù)協(xié)議，即可遠(yuǎn)程請求服務(wù)。RRPC則可以實現(xiàn)由服務(wù)端請求設(shè)備端并能夠傳輸控制協(xié)議（英語：TransmissionControlProtocol，縮寫為TCP）是一種面向連接IETFRFC793定義。在簡化的計算機(jī)定端口（80端口）TCP連接。HTTP服務(wù)器則在那個端口監(jiān)聽客戶端的請求。超文本傳輸安全協(xié)議（英語：HypertextTransferProtocolSecure，縮寫：HTTPS，HTTPoverTLS，HTTPoverSSLHTTPSecure）是一種網(wǎng)絡(luò)安全傳輸協(xié)議。在計算機(jī)網(wǎng)絡(luò)上，HTTPSSSL/TLS來對數(shù)據(jù)包進(jìn)行加密。HTTPS開發(fā)的主要目的，是提供對網(wǎng)絡(luò)服務(wù)器的身份認(rèn)證，保護(hù)交換數(shù)據(jù)的隱私與完整性。HTTPS啞設(shè)備/DNC(DistributedNumericalControl)稱為分布式數(shù)控，是網(wǎng)絡(luò)化數(shù)控機(jī)床常用的制造術(shù)IOTAPI圖 系統(tǒng)架HTTPAPI（Auth）requestheaderX-Authorization:Bearer{Token}，做為該接口的權(quán)限認(rèn)證。ResponseJSON"status":"message":"Tokenhasexpired","errorCode":11,200API1statusNot2errorCode基礎(chǔ)設(shè)施管

{ \h\hStatusInvalidusernameorAPI之前的認(rèn)證。

trueor

X-Authorization:Bearer{token}\hX-Authorization:Bearer{token}\h"firstName":"易","lastName":"通","entityType":"TENANT", "additionalInfo":{"tenantId用戶所屬租戶ID，如果為客戶則為customerId"entityType":"TENANT","customerId":{"email":"\hyt@","firstName":"易","name":\h

用戶ID需要查詢的用戶ID X-Authorization:Bearer{token}

X-Authorization:Bearer{token}":"X-Authorization:Bearer{token}":"

StatusStatusCode:200

X-Authorization:Bearer{token}X-Authorization:Bearer{token}"id":"id":"createdTime":dddddddf,"additionalInfo":{"tenantId":{"customerId":{\h"firstName":"易","customerName":null,"customerName":null,\h"activation":true

X-Authorization:Bearer{token}X-Authorization:Bearer{token}

X-Authorization:Bearer{token}\hX-Authorization:Bearer{token}\hStatusStatusCode:200租戶管理JSONIDID則修改指定租戶信息。

X-Authorization:Bearer{token}X-Authorization:Bearer{token}"city":"ChengDu","country":"phone":"state":"zip":"id":"additionalInfo":{"country":"state":"city":"ChengDu","address2":null,"zip":"phone":"email":null,"region": textOffset偏移量（分頁使用）"data":"data":"id":"additionalInfo":null,"country":null,"state":"city":null,"address":null,"address2":null,"zip":null,"phone":"email":null,"region":"Global","adminCount":1,"userCount":0,},"id":"additionalInfo":{"country":"address":1019號","zip":"610000","phone":\h"title":"測試租戶","region":"Global","adminCount":1,"userCount":0,"hasNext":falseID獲取租戶信息。

tenantId"id":"additionalInfo":null,"country":null,"address":"tt","address2":null,"zip":null,"phonexxxxxx6","email":null,"title測試租戶"region":"userCount":0,ID租戶。

StatusCode:200 客戶管理JSONIDID則修改指定租戶信息。

X-Authorization:Bearer{token}X-Authorization:Bearer{token}"country":null,//客戶國家，可選"state":null,//省，可選"city":null,//城市，可選"address":null,//地址，可選"zip":null,//郵編，可選"phone":null,//電話,可選"email":null,//郵箱，可選"id":},//客戶"country":null,//客戶國家，創(chuàng)建時指定"state":null,//省，創(chuàng)建時指定"city":null,//城市，創(chuàng)建時指定"address":null,//地址，創(chuàng)建時指定"zip":null,//郵編，創(chuàng)建時指定"phone":null,//電話"email":null,//郵箱"tenantId":{

X-Authorization:Bearer{token}X-Authorization:Bearer{token}"data":"id":"country":null,"state":null,"city":null,"address":null,"address2":null,"zip":null,"phone":"email":null,"tenantId":{"userCount":0,"hasNext":falseID的客戶信息。

Q/YG004— "id":"createdTime":148,"country":null,"state":null,"city":null,"address":null,"zip":null,"phone":"email":"tenantId":{"infrastructureCount":0,查詢指定客戶的客戶名ID的客戶名(title)。

Q/YG004—titletitle查詢客戶信息。

customerTitle"id":"country":null,"state":null,"city":null,"address2":null,"zip":null,"phone":"email":null,"tenantId":{"name":"測試客戶"ID的客戶。

Q/YG004—

StatusCode:200 設(shè)備管理JSONIDID則修改指定設(shè)備信息。 Jsonpost消息 addonanfo"{"descpon"是個明} /加息，個意son此是條備明選填

Q/YG004—"name":"這是一個測試設(shè)備",//設(shè)備名稱，必填 "id":": "tenantId":{"customerId備不屬于任何客戶，可以調(diào)用分配設(shè)備給客戶api分配，參考2.5.6分配設(shè)備給客戶:":"ID的設(shè)備。device

X-Authorization:Bearer{token}X-Authorization:Bearer{token}StatusCode:200 ID的設(shè)備。

device "id":"additionalInfo":{"tenantId設(shè)備所屬租戶的租戶id"entityType":"TENANT","customerId設(shè)備所屬的客戶的客戶id"entityType":"CUSTOMER","type":"應(yīng)力傳感器"

Q/YG004—

"data":"data":"id":"createdTime":1644,"tenantId":{"customerId":{"name":"limit":1,//"limit":1,//分頁大小限制"textSearchBound":null,":"":ID所屬的設(shè)備中查詢設(shè)備列表。

:[//:[//"id":"createdTime":15444,"tenantId":{Q/YG004—"customerId":{"name":"nextPageLink":{//分頁對象"limit":1,//分頁大小限制"textSearchBound":null,":"IDID的客戶。

"id":"additionalInfo":{ID的設(shè)備取消分配已分配的客戶。

"id":"createdTime":1562,"additionalInfo":{TOKEN信息。

"id": },//設(shè)備"credentialsType":"ACCESS_TOKEN",//credential類型，此處為ACCESS_TOKEN"credentialsValue":null//credential類型為ACCESS_TOKEN時此處為空

"tenantId":{"tenantId":{},//設(shè)備類型所屬租戶id"entityType":"DEVICE","tenantId":{"type":"靜力水準(zhǔn)儀"等。詳見6.1（Entity）及實體間關(guān)系說明。查詢指定設(shè)備（實體）Q/YG004—

tes/SERVER_SCOPE?key=型號,sn號tes/SERVER_SCOPE?key=型號,sn號"速度"ts":"value":"航向"ts":"value":查詢設(shè)備（實體）指定時間段時間序列歷史數(shù)據(jù)（可指定聚合方式Q/YG004—"ts": "速度"ts":"value":"航向"ts":"value": 查詢設(shè)備（實體）

3.1 "型號StatusCode:200 查詢實體的所有屬性（ Q/YG004—"sn"sn號",SCOPE中的所有屬性（SCOPE中，查詢指定實體的所有屬性鍵Q/YG004—3.1"sn"sn號",Q/YG004—"lastUpdateTs":15,//"key":"型號",//屬性鍵 ibutes?keys=型號,snibutes?keys=型號,sn號"key":"sn號","key":"型號","value":SCOPESCOPE中，查詢指定實體的屬性 3.1"key":"型號",//屬性鍵 ibutes/SERVER_SCOPE?key=型號,snibutes/SERVER_SCOPE?key=型號,sn號"key":"sn號","key":"型號","value":SCOPE

3.1 StatusCode:200 WebsocketAPI

Q/YG004—websocket后臺服務(wù)，調(diào)用通過訂閱命令和取消訂閱命令，訂閱來自

Q/YG004— Authtoken":"":historyCmds:[],attrSubCmds:[]"subscriptionId":0,//訂閱idA：針對同一設(shè)備傳來的多種傳感器鍵值對，若需要獨立訂閱不同傳感器鍵值，CwebSocketwebSocket，但最好只創(chuàng)建唯一Q/YG004—"scope":"LATEST_TELEMETRY",historyCmds:[],attrSubCmds:[]tsSubCmds:tsSubCmds:[],"entityId5074b200-e31a-11e8-be95-f3713e6700c3實體ID"keys":"crackWidth,crackDeepth","startTs1999990243,// "interval":2000000, 時間段時間序列歷史數(shù)據(jù)對應(yīng)參數(shù)描述"limit":attrSubCmds:tsSubCmds:[],historyCmds:tsSubCmds:[],historyCmds:[],attrSubCmds: