文档数据上传接口数据上传接口
数据上传接口

数据上传接口

更新于 2022-08-29

接口描述

本接口为数据上传接口。
通过调用此接口可以上传数据信息。

接口调用

  • POST /api/dataExternals/upload?equipType=1&equipId=1234 HTTP/1.1
    Host: dev.thuwater.com
    X-TH-TOKEN: 26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766
    
    [{"timestamp":"2019-01-01 00:00:00","xxx":"7.2","yyy":"2.2","zzz":2.2.....},
    {"timestamp":"2019-01-01 00:01:00","xxx":"7.3","yyy":"2.2".....},
    {"timestamp":"2019-01-01 00:05:00","xxx":"7.4","yyy":"2.1","zzz":"22.0".....}]

调用参数

参数名称必填说明
X-TH-TOKEN是对接时提供
equipType是设备类型,自定义字符串
equipId是设备ID,自定义字符串
body是json列表,总大小不应该超过500kb

Body参数说明

参数名称说明
timestamp必填 时间戳 格式 yyyy-MM-dd HH:mm:ss
xxx上传的数据字段与值 请根据实际情况填写,然后请提供一份 设备ID/设备名称/设备类型/测量字段标识/物理单位 的对应关系表
yyy上传的数据字段与值 请根据实际情况填写,然后请提供一份 设备ID/设备名称/设备类型/测量字段标识/物理单位 的对应关系表

接口响应

  • HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "result": true, 
        "msg": ""
    }

响应参数

参数名称说明
httpcode200-正常,401-无权限,406 不接受的参数或方法,500-其他错误。

返回说明

网络状况不好可能导致无响应/超时等
如果网络正常,返回 HTTP Status Code

  • 200 正常
  • 401 权限不够,具体就是X-TH-TOKEN的值过期或者失效
  • 406 不接受的参数或方法,请检查是否发送了配置错误的请求
  • 500 服务器错误,请过一段时间再重试