批量上报测点信息¶
批量上报测点适用于以下几种场景:
网关设备代理子设备批量上报数据;
直连设备批量上报不同时间戳的数据;
兼有以上场景;
备注
根据模型中的输入参数和输出参数来配置下列的参数。如果请求中部分数据发送失败,整个请求全部发送失败,返回第一个出现的错误码。
上行
请求TOPIC:
/sys/{productKey}/{deviceKey}/thing/measurepoint/post/batch
响应TOPIC:
/sys/{productKey}/{deviceKey}/thing/measurepoint/post/batch_reply
请求数据格式¶
{
"id":"123",
"version":"1.0",
"allowOfflineSubDevice": true,
"skipInvalidMeasurepoints": true,
"params":[
{
"productKey":"product1",
"deviceKey":"device1",
"measurepoints":{
"Power":{
"value":1,
"quality":9
},
"temp":1.02,
"branchCurr":[
"1.02",
"2.02",
"7.93"
]
},
"time":123456
},
{
"productKey":"product1",
"deviceKey":"device1",
"measurepoints":{
"Power":{
"value":2,
"quality":9
},
"temp":2.02,
"branchCurr":[
"2.02",
"3.02",
"9.93"
]
},
"time":123567
},
{
"productKey":"product2",
"deviceKey":"device2",
"measurepoints":{
"Power":{
"value":1,
"quality":9
},
"temp":1.02,
"branchCurr":[
"1.02",
"2.02",
"7.93"
]
},
"time":123456
}
],
"method":"thing.measurepoint.post.batch"
}
响应数据格式¶
{
"id":"123",
"code":200,
"data":{
}
}
参数说明¶
参数 |
类型 |
是否必需 |
描述 |
id |
String |
可选 |
消息 ID 号,保留值 |
version |
String |
必需 |
协议版本号,目前协议版本1.0 |
allowOfflineSubDevice |
boolean |
可选 |
是否允许给离线子设备发测点数据,默认false。如果该选项为false且请求中存在离线子设备,那么整个请求将会拒绝 |
skipInvalidMeasurepoints |
boolean |
可选 |
是否忽略请求中格式无效的测点数据,默认false。如果该选项为false且请求中存在无效测点,那么整个请求将会拒绝 |
params |
Object |
必需 |
上报测点所需的参数 |
productKey |
String |
可选 |
设备的product key。如需上报具体子设备的数据,需要提供子设备的productKey和deviceKey;如不提供子设备的productKey和deviceKey,则默认使用网关设备topic的这两个参数 |
deviceKey |
String |
可选 |
设备的device key。如需上报具体子设备的数据,需要提供子设备的productKey和deviceKey;如不提供子设备的productKey和deviceKey,则默认使用网关设备topic的这两个参数 |
method |
String |
必需 |
请求方法 |
measurepoints |
Object |
必需 |
需上报的测点的标识符的列表 |
power |
String |
可选 |
要上报的测点的标识符,在此示例中为属性 power 的标识符。此处设置的格式必须与服务的数据类型匹配。例如,当质量位被选择时,此处的数据即为 value 和 quality |
value |
Integer |
可选 |
该测点的标识符。在本例中,为参数 value。此处设置的值必须与服务的数据类型匹配。例如,当此参数的数据类型在模型中设置为integer时,那么值必须为integer |
quality |
Integer |
可选 |
该测点的标识符。在本例中,为参数 quality。如上,此处设置的值必须与服务的数据类型匹配 |
temp |
String |
可选 |
要上报的测点的标识符,在此示例中为属性 temp 的标识符。如上,此处设置的值必须与服务的数据类型匹配 |
branchCurr |
String |
可选 |
要上报的测点的标识符,在此示例中为属性 branchCurr 的标识符。如上,此处设置的值必须与服务的数据类型匹配 |
time |
Timestamp |
可选 |
测点的时间戳。如果为空,时间戳会被设为服务器的时间 |
code |
Integer |
必需 |
结果返回码。200代表请求成功执行 |
data |
JSON |
可选 |
返回的详细信息。JSON格式 |
结果返回码¶
返回码 |
错误信息 |
释义 |
---|---|---|
1204 |
Model validate failed |
测点格式不符合模型规定 |
1206 |
Measurepoint post data format error |
JSON请求格式无效 |
1212 |
No sub-device permission |
子设备不在线或者子设备没有通过指定的网关接入云端 |