本接口用于推送设备测点数据，例如推送电能表电压等数据。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
energy:PushDeviceData |
none |
*全部资源
|
无 | 无 |
请求语法
POST /api/v1/data/increment/push HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求体参数。 |
|
| deviceType |
string |
是 |
设备类型。 查看设备类型定义 |
1 |
| devices |
array<object> |
是 |
推送数据的设备列表 |
|
|
array<object> |
是 |
|||
| deviceId |
string |
是 |
deviceType 为 12、13、17 需要传 system_id（字段名称仍为 device_id) deviceType 为 15、16 不传 其他情况必传。 |
设备ID |
| recordTime |
string |
是 |
测点数据产生时间。 |
2021-09-08 18:40:00 |
| data |
object |
是 |
测点信息 避免精度问题，测点数据统一传字符串 缺少必填字段功能无法正常使用 缺少推荐字段，部分功能可能会收到影响，具体影响详见附录中的设备测点备注 参考测点定义 |
{ "dp_imp": "329.0", "F": "148.0", "eq_imp": "363.0", "Ep_imp_1": "128.0", "Ep_imp_2": "157.0", "Ua": "226.0", "Ub": "285.0", "Ep_imp": "325.0", "Uc": "342.0", "Ep_imp_3": "109.0", "Ep_imp_4": "94.0", "P": "514.0", "Pa": "443.0", "Q": "265.0", "dp_exp": "261.0", "eq_exp": "399.0", "COSQ": "223.0", "Ia": "240.0", "Ib": "216.0", "Ic": "229.0", "Ep_exp": "115.0", "VdisPer": "120.0" } |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回结构体。 |
||
| requestId |
string |
请求 ID。 |
83A5A7DD-8974-5769-952E-590A97BEA34E |
| data |
string |
数据是否推送成功。 成功返回 success。 |
success |
示例
正常返回示例
JSON格式
{
"requestId": "83A5A7DD-8974-5769-952E-590A97BEA34E",
"data": "success"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。