Skip to main content

简介

概述​

数据中台通过 OpenAPI 为开发者提供了完整的设备数据集成与管理能力。开发者能够将外部系统与数据中台深度集成，实现设备数据的自动化采集、查询与分析，同时确保数据传输的安全性。

OpenAPI 操作主要分为两个核心部分：令牌安全管理和 API 核心功能。

令牌安全管理​

tip

RSA令牌：基于非对称加密算法的API认证凭证，采用公钥加密、私钥解密的机制确保数据传输安全。

JWT令牌：基于JSON的开放标准令牌，采用数字签名确保令牌的完整性和可信度。

  1. 支持 RSA 和 JWT 两种令牌认证机制

  2. RSA 令牌采用非对称加密，确保传输安全；JWT 令牌适用于用户级授权

  3. 提供完整的令牌生命周期管理：申请、授权配置、下载/复制、删除

  4. 每个令牌可精细控制 API 访问权限和项目数据范围

API 核心功能​

tip

数据服务API：供外部系统（如运营仪表盘、移动端APP）调用数据中台数据的标准化接口，支持查询和订阅模式。

  1. 设备数据操作：支持设备时序数据推送（单次最多1000条）、设备详情查询、设备列表分页查询、设备点位最新值与历史值查询

  2. 数仓数据集成：提供数据集数据的推送与查询接口

  3. 统一认证机制：所有接口均通过加密令牌在请求头中进行身份验证

  4. 常见错误处理：包含常见的错误码体系，如 401（令牌过期）、428（用户不存在）等