值说明:
- 字符集编号
默认UTF-8 - 时间格式
默认为时间戳,毫秒为准,即UTC时间1970-01-01 00:00:00.000距今的毫秒数。 - 公钥和私钥
公钥和私钥可以和负责人联系获取。
公钥即为项目编号, 参数值为 projectCode。
私钥参数值为 secret。
基本请求参数:
- 加密认证:
访问每个接口都要加密校验,判断访问权限。
由于接口都要加这3个参数,所以其它接口的请求参数不再重复这3个参数(特殊接口另外说明) - 加密认证参数
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
projectCode | 是 | string | 项目编号(公钥) |
time | 是 | string | 当前时间戳 |
sign | 是 | string | 加密密文 |
- sign加密密文设定方法:
sign通过MD5运算获取,以32位小写为准。
组合值为sign = MD5(projectCode + secret + time)
返回参数:
除了接口登录我们系统外,其它数据一般以JSON格式返回(其它接口特殊说明)。
实例:
{
"status": 0,
"msg": '',
"data": ,
}
返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
状态码 | int | 0:成功,1:失败 |
msg | string | 返回信息 |
data | - | 返回数据 |
基本返回信息msg说明:
返回信息 | 说明 |
---|---|
系统维护中~ | 计量Saas系统正在升级维护中 |
参数有误 | 缺少参数 |
时间参数已过期 | time时间戳与当前时间戳相差过多 |
不存在项目数据 | 项目编号(公钥)有误 |
无法通过接口登录本系统 | 项目没开放接口登录(只针对接口登录计量Saas系统) |
接口已关闭,无法使用 | int |
状态码 | 项目没开放接口信息获取 |
参数验证失败 | 加密认证或方法有误,无法对应 |
文档更新时间: 2023-05-09 08:50 作者:特