跳转至

概述

为了方便第三方服务与云平台对接,为使用云平台的用户开放和设备数据相关的API

  1. 云平台API地址需咨询供应商,后续文档中平台API地址简称为<%=BaseUrl%>;也可以通过API地址查询接口获取API服务器地址信息
  2. 除非特殊说明,API的接收和返回参数编码方式都为UTF-8;
  3. API接口返回数据为JSON格式时,在后续的升级中会进行字段扩展,但都会兼容旧版本;
  4. 调用所有接口(除登录接口外)前,需要先调用/user/getToken登录接口获取token值;登录接口需要的账户信息即为云平台账号。
  5. 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 字符串数组