跳至主要内容

簡介

概述​

數據中台透過 OpenAPI 為開發者提供了完整的設備數據整合與管理能力。開發者能夠將外部系統與數據中台深度整合，實現設備數據的自動化採集、查詢與分析，同時確保數據傳輸的安全性。

OpenAPI 操作主要分為兩個核心部分：令牌安全管理和 API 核心功能。

令牌安全管理​

提示

RSA令牌：基於非對稱加密演算法的API認證憑證，採用公鑰加密、私鑰解密的機制確保數據傳輸安全。

JWT令牌：基於JSON的開放標準令牌，採用數位簽章確保令牌的完整性和可信度。

  1. 支援 RSA 和 JWT 兩種令牌認證機制

  2. RSA 令牌採用非對稱加密，確保傳輸安全；JWT 令牌適用於使用者級授權

  3. 提供完整的令牌生命週期管理：申請、授權配置、下載/複製、刪除

  4. 每個令牌可精細控制 API 存取權限和專案數據範圍

API 核心功能​

提示

數據服務API：供外部系統（如營運儀表板、行動端APP）呼叫數據中台數據的標準化介面，支援查詢和訂閱模式。

  1. 設備數據操作：支援設備時序數據推播（單次最多1000條）、設備詳情查詢、設備列表分頁查詢、設備點位最新值與歷史值查詢

  2. 數倉數據整合：提供數據集數據的推播與查詢介面

  3. 統一認證機制：所有介面均透過加密令牌在請求頭中進行身份驗證

  4. 常見錯誤處理：包含常見的錯誤碼體系，如 401（令牌過期）、428（使用者不存在）等