亿捷云开放平台 API 接口规范 v1.3

文档编号：YJ-API-SPEC-20260121

发布单位：杭州亿捷科技有限公司

1. 认证方式

GET /api/v1/devices?access_token=xxx
Header: X-YJ-AppId: yjyun-app-2026

2. 核心接口示例

POST /api/v1/data/upload —— 上报设备实时数据（JSON格式）
GET /api/v1/alerts?device_id=DEV001 —— 查询设备告警记录
PUT /api/v1/dashboards/{id} —— 更新可视化看板配置

3. 数据格式约定

{
  "device_id": "SN-202601001",
  "timestamp": "2026-01-21T10:30:45Z",
  "payload": {
    "temp": 25.3,
    "humidity": 62.1,
    "voltage": 12.4
  }
}

4. 限流策略

免费版：10次/分钟；企业版：60次/分钟；支持 OAuth2.0 与 JWT 双重鉴权。