本接口为数据上传接口。
通过调用此接口可以上传数据信息。
-
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 |
参数名称 | 说明 |
---|
timestamp | 必填 时间戳 格式 yyyy-MM-dd HH:mm:ss |
xxx | 上传的数据字段与值 请根据实际情况填写,然后请提供一份 设备ID/设备名称/设备类型/测量字段标识/物理单位 的对应关系表 |
yyy | 上传的数据字段与值 请根据实际情况填写,然后请提供一份 设备ID/设备名称/设备类型/测量字段标识/物理单位 的对应关系表 |
参数名称 | 说明 |
---|
httpcode | 200-正常,401-无权限,406 不接受的参数或方法,500-其他错误。 |
网络状况不好可能导致无响应/超时等
如果网络正常,返回 HTTP Status Code
- 200 正常
- 401 权限不够,具体就是X-TH-TOKEN的值过期或者失效
- 406 不接受的参数或方法,请检查是否发送了配置错误的请求
- 500 服务器错误,请过一段时间再重试