本接口用于推送设备测点数据,例如推送电能表电压等数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用前面加 * 表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
energy:PushDeviceData | none | *全部资源 * |
| 无 |
请求语法
POST /api/v1/data/increment/push HTTP/1.1
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
body | object | 否 | 请求体参数。 | |
deviceType | string | 是 | 设备类型。 查看设备类型定义 | 1 |
devices | array<object> | 是 | 推送数据的设备列表 | |
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" } |
返回参数
示例
正常返回示例
JSON
格式
{
"requestId": "83A5A7DD-8974-5769-952E-590A97BEA34E",
"data": "success"
}
错误码
访问错误中心查看更多错误码。