智慧环保平台
  1. 数据接口
智慧环保平台
  • 数据接口
    • 数据接口文档
    • 登录
      POST
    • 历史数据
      POST
    • 设备状态
      POST
  1. 数据接口

数据接口文档

介绍#

服务说明#

TODO

服务地址#

TODO

身份验证#

请求数据接口前,应该有以下的验证信息。
名称属性说明
用户名Account
密码Passwd
公钥PublicKey
私钥SecretKey

1. 获取私钥#

本服务提供数据开放功能,调用接口前请先向管理员申请调用私钥(SecretKey)。
不要与他人共享或在任何客户端代码(浏览器、应用程序)中公开私钥。生产请求必须通过您自己的后端服务器进行路由,私钥可以从环境变量或密钥管理服务中安全加载。

2. 使用私钥获取接口调用token#

请求接口
/api/ShareApiGateway/Login
请求方式
POST
请求参数
参数类型说明
publicKeystring公钥
accountstring用户名
passwordstring密码
timestampstring时间戳
signaturestring签名
请求示例
{
  "publicKey": "123",
  "timestamp": "1700127835",
  "signature": "8ffbaeabd7d7707e56b896514d88c5983dc53723235890b1e0248fa7936085a8ff53ddd7996c030d4e9c81177dfe972171f75484d76",
  "account":"system",
  "password":"4a7d1ed414474e4033ac253d9b"
}
响应
参数类型说明
Tokenstring请求密钥
ExpireTimestring过期时间
{
    "type": 1,
    "errorcode": 0,
    "message": "ok",
    "resultdata": {
        "Token": "C955A73F8996D1F1AFE3568694DEBC542E3EE7F25126A8FCB55D3A6FD1AB75C46785A1558045BE47",
        "ExpireTime": "2023-11-17 22:41:13"
    }
}

2.1 签名计算#

将字符串
public_key=publicKey&ts=Timestamp&account=account&passwd=password
使用 DES 方式进行加密,其中DES加密的key和iv使用私钥MD5后hex字符串大写前八位
计算示例
例如私钥为 06aad4ef3a3c , MD5后 7D1240F7EFEEF1214AB5556B5DA47267,key和iv使用 7D1240F7
使用在线工具验证结果 https://ctool.dev/tool.html#/tool/encrypt/des/encrypt?category=encryption

3. 发出请求#

所有 API 请求都应在 HTTP 标头(Header)中包含您的 API 请求密钥(Token)
curl 命令示例:
 curl http://localhost:8888/v1/models/data -H 'token: <Token>'
其中 <Token> 请求登录接口后响应的Token参数

数据接口#

TODO
修改于 2023-11-17 06:53:40
下一页
登录
Built with