Skip to main content

API 接口文档

概述​

本文档描述了能耗管理平台的完整 API 接口，包括设备接入、数据上传等功能。

基本信息​

  • 服务地址: http://iot.datacom.vip:11111
  • 数据格式: JSON
  • 字符编码: UTF-8

快速开始​

1. 获取 Token​

POSTMAN 设置

接口地址: http://iot.datacom.vip:11111/Generate_Token

请求方式: POST

Headers:

KeyValue
Content-Typeapplication/json

Body (raw JSON):

{
  "Appkey": "your_appkey",
  "Secret": "your_secret"
}

2. 使用 Token 调用接口​

POSTMAN 设置

接口地址: http://iot.datacom.vip:11111/Get_MeterInfo

请求方式: POST

Headers:

KeyValue
Content-Typeapplication/json
AuthorizationBearer your_token

Body (raw JSON):

{
  "BuildID": "1234567890"
}

接口分类​

认证接口

Token 生成和验证

设备管理

设备注册、查询、删除

数据上传

能耗数据上报

错误码

错误码说明和 RequestID

响应格式​

所有接口返回统一的 JSON 格式：

{
  "Code": 200,
  "Type": "Success",
  "Message": "操作成功",
  "Data": {},
  "RequestID": "unique-request-id"
}

响应字段说明​

字段类型说明
Codenumber响应码，200 表示成功
Typestring响应类型（Success/Error）
Messagestring响应消息
Dataobject/array响应数据
RequestIDstring请求唯一标识，用于日志追踪

认证说明​

除 /Generate_Token 接口外，其他接口都需要认证。

在请求头中添加 Token：

KeyValue
AuthorizationBearer <your_token>

或

KeyValue
Authorization<your_token>

数据说明​

时间格式​

所有时间字段使用以下格式：

YYYY-MM-DD HH:MM:SS

例如：2025-03-17 10:30:00