数据上传接口
数据上传接口
接口描述
本接口为数据上传接口。
通过调用此接口可以上传数据信息。
接口调用
-
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".....}] -
var request = require("request"); var options = { method: 'POST', url: 'https://dev.thuwater.com/api/dataExternals/upload?equipType=1&equipId=1234, "data": { }, headers: { 'Host': 'dev.thuwater.com', 'X-TH-TOKEN': '26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766' } }; request(options, function (error, response, body) { if (error) throw new Error(error); console.log(body); }); -
OkHttpClient client = new OkHttpClient(); HttpUrl url = HttpUrl.parse("https://dev.thuwater.com/api/data/range") .newBuilder() .addQueryParameter("equipType","1") .addQueryParameter("equipId","1234") .build(); String josn ="[\n" + " {\"timestamp\":\"2019-01-01 00:00:00\",\"xxx\":\"7.2\",\"yyy\":\"2.2\",\"zzz\":2.2.....},\n" + " {\"timestamp\":\"2019-01-01 00:01:00\",\"xxx\":\"7.3\",\"yyy\":\"2.2\".....},\n" + " {\"timestamp\":\"2019-01-01 00:05:00\",\"xxx\":\"7.4\",\"yyy\":\"2.1\",\"zzz\":\"22.0\".....}\n" + "]\n"; RequestBody requestBody = RequestBody.create(josn, JSON); Request request = new Request.Builder() .url .post(requestBody) .addHeader("X-TH-TOKEN", "26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766") .build(); Response response = client.newCall(request).execute();
调用参数
| 参数名称 | 必填 | 说明 |
|---|---|---|
| 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": "" }
响应参数
| 参数名称 | 说明 |
|---|---|
| httpcode | 200-正常,401-无权限,406 不接受的参数或方法,500-其他错误。 |
返回说明
网络状况不好可能导致无响应/超时等
如果网络正常,返回 HTTP Status Code
- 200 正常
- 401 权限不够,具体就是X-TH-TOKEN的值过期或者失效
- 406 不接受的参数或方法,请检查是否发送了配置错误的请求
- 500 服务器错误,请过一段时间再重试
内容来源于 THWater 官方开发文档查看原文
© 2026 THWater · 北京清环智慧水务科技有限公司