多協議接入 產品介紹
產品簡介 產品架構 資源模型 協議適用場景 名詞解釋
快速入門
帳戶與登入
帳戶註冊 帳戶認證
產品與設備
創建產品 創建單個設備 批量創建設備 批量匯出設備
數據流與數據點
用戶指南
規則引擎
服務介紹 規則配置 基礎數據格式 SQL
HTTP推送
服務介紹 服務配置 開發指南 SDK
安全鑒權
概述 token演算法 演算法示例
java python
應用管理
服務介紹 控制項介紹 操作說明
開發指南
EDP
設備開發
文檔與工具 協議介紹 開發流程 常見問題
API
API使用 SDK API列表
新增設備 註冊設備 更新設備 查詢設備詳情 批量查詢設備詳情 批量查詢設備狀態 刪除設備 新增數據流 更新數據流 查詢數據流 批量查詢數據流 刪除數據流 查詢設備歷史數據 批量查詢設備數據 上載數據點 上載文件 獲取文件 發送命令 查詢命令狀態 查詢命令回應 查詢設備歷史命令 新增觸發器 更新觸發器 查詢觸發器 刪除觸發器 新增apikey 更新apikey 查詢apikey 刪除apikey
TCP透傳
設備開發
文檔與工具 協議介紹 開發流程
API
API使用 SDK API列表
新增設備 註冊設備 更新設備 查詢設備詳情 批量查詢設備詳情 批量查詢設備狀態 刪除設備 新增數據流 更新數據流 查詢數據流 批量查詢數據流 刪除數據流 查詢設備歷史數據 批量查詢設備數據 上載數據點 上載文件 獲取文件 發送命令 查詢設備歷史命令 新增觸發器 更新觸發器 查詢觸發器 刪除觸發器 新增apikey 更新apikey 查詢apikey 刪除apikey
MQTT
設備開發
文檔與工具 協議介紹 開發流程 常見問題
API
API使用 SDK API列表
新增設備 註冊設備 更新設備 查詢設備詳情 查詢設備詳情 批量查詢設備詳情 刪除設備 新增數據流 更新數據流 查詢數據流 批量查詢數據流 刪除數據流 查詢設備歷史數據 批量查詢設備數據 上載數據點 上載文件 獲取文件 發送命令 查詢命令狀態 查詢命令回應 查詢設備歷史命令 新增觸發器 更新觸發器 查詢觸發器 刪除觸發器 新增apikey 更新apikey 查詢apikey 刪除apikey 發佈消息 查詢訂閱topic設備 查詢設備訂閱topic 查詢產品topic
Modbus
設備開發
文檔與工具 協議介紹 開發流程
API
API使用 SDK API列表
新增設備 更新設備 查询设备详情 批量查詢設備詳情 批量查詢設備狀態 刪除設備 新增數據流 更新數據流 查詢數據流 批量查詢數據流 刪除數據流 查詢設備歷史數據 批量查詢設備數據 上載數據點 發送命令 查詢命令狀態 查詢命令回應 查詢設備歷史命令 新增觸發器 更新觸發器 查詢觸發器 刪除觸發器 新增apikey 更新apikey 查詢apikey 刪除apikey
HTTP
API使用 SDK 協議介面清單
新增設備 註冊設備 更新設備 查詢設備詳情 批量查詢設備詳情 批量查詢設備狀態 刪除設備 新增數據流 更新數據流 查詢數據流 批量查詢數據流 刪除數據流 查詢設備歷史數據 批量查詢設備數據 上載數據點 上載文件 獲取文件 查询设备历史命令 新增觸發器 更新觸發器 查詢觸發器 刪除觸發器 新增apikey 更新apikey 查詢apikey 刪除apikey
常見問題
平台地址清單 技術類 商務類 OCP類

token 算法

token由多個參數構成，如下表：

Item Type 是否必須 參數說明 參數示例
version string 是 參數組版本號，日期格式，目前僅支援“2018-10-31” 2018-10-31
res string 是 訪問資源 resource 格式為：父資源類/父資源ID/子資源類/子資源ID 見res使用場景說明 products/123123 products/123123/devices/ mqs/osndf09nand9f21390
et int 是 訪問過期時間expirationTime，unix時間 當一次訪問參數中的et時間小於當前時間時，平台會認為訪問參數過期從而拒絕該訪問 1537255523 表示：北京時間2018-09-15:25:23
method string 是 簽名方法signatureMethod 支援md5 、sha1、sha256 sha256
sign string 是 簽名結果字串signature

關於token參數的特別說明：

res使用場景說明

使用場景如下表：

場景 res參數格式 示例
API訪問 products/{pid} products/123123
設備連接 products/{pid}/devices/{device_name} products/123123/devices/m

sign簽名算法

參數sign的生成演算法為：

sign = base64(hmac_<method>(base64decode(accessKey), utf-8(StringForSignature)))

其中：

  • accessKey為OneNET為獨立資源（例如，產品）分配的唯一訪問金鑰，其作為簽名演算法參數之一參與簽名計算，為保證訪問安全，請妥善保管
  • accessKey參與計算前應先進行base64decode操作
  • 用於計算簽名的字串StringForSignature的組成順序按照參數名稱進行字串排序，以'/n'作為參數分隔，當前版本中按照如下順序進行排序：et、method、res、version

StringForSignature組成示例如下：

StringForSignature = et + '\n' + method + '\n' + res+ '\n' + version

注意：每個參數均為key＝value格式組成，但是僅參數中的value參與計算簽名的字串StringForSignature的組成，若token參數如下

et = 1537255523
method = sha1
res = products/123123
version = 2018-10-31

則用於計算簽名的字串StringForSignature為（按照et、method、res、version的順序）

StringForSignature = "1537255523" + "\n" + "sha1"+ "\n" + "products/123123"+ "\n" + "2018-10-31"

計算出sign後，將每個參數均採用key＝value的形式表示，並用'&'作為分隔符號，示例如下：

version=2018-10-31&res=products/123123&et=1537255523&method=sha1&sign=ZjA1NzZlMmMxYzIOTg3MjBzNjYTI2MjA4Yw=

參數編碼

token中key＝value的形式的value部分需要經過URL編碼，需要進行編碼的特殊符號如下：

No. 符號 編碼
1 + %2B
2 空格 %20
3 / %2F
4 ? %3F
5 % %25
6 # %23
7 & %26
8 ＝ %3D

編碼後，上例中實際傳輸token為：

version=2018-10-31&res=products%2F123123&et=1537255523&method=sha1&sign=ZjA1NzZlMmMxYzIOTg3MjBzNjYTI2MjA4Yw%3D

个搜索结果，搜索内容 “”

    0 个搜索结果，搜索内容 “”