概述
为了方便第三方服务与云平台对接,为使用云平台的用户开放和设备数据相关的API。
- 云平台API地址需咨询供应商,后续文档中平台API地址简称为<%=BaseUrl%>;也可以通过API地址查询接口获取API服务器地址信息
- 除非特殊说明,API的接收和返回参数编码方式都为UTF-8;
- API接口返回数据为JSON格式时,在后续的升级中会进行字段扩展,但都会兼容旧版本;
- 调用所有接口(除登录接口外)前,需要先调用/user/getToken登录接口获取token值;登录接口需要的账户信息即为云平台账号。
- token默认有效期为600分钟。
API数据类型约定
API接口返回的数据类型规定如下表:
数据类型标识 | 数据类型 |
---|---|
1 | Boolean |
2 | Byte |
3 | Word/UInt16 |
4 | DWord/UInt32 |
5 | Float |
6 | Double |
7 | Int16 |
8 | Int32 |
a | 数值 |
b | 开关量 |
s | 字符串 |
A | 数组 |
aa | 数值数组 |
ba | 开关量数组 |
sa | 字符串数组 |