累计型测点接口规范


累计型测点 类型的接口提供测点的当日累计数值。将 累计型测点 类型的接口注册为数据源之前,需按照以下规范对接口进行标准化。


HTTP 请求方法


POST

请求参数


名称 必需/可选 数据类型 描述
orgId 必需 String 测点所属的组织 ID。
mdmIds 必需 String 测点对应的对象实例的标识符,多个对象实例之间用英文逗号隔开。
pointIds 必需 String 测点的标识符,多个测点之间用英文逗号隔开。
timeGroup 必需 String 测点聚合的时间粒度。目前支持以下时间粒度:D(天)。

响应参数


名称 必然/可能返回 数据类型 描述
data 必然返回 PointData 结构体 描述测点的信息。参见 PointData 结构体

PointData 结构体


名称 必然/可能返回 数据类型 描述
pointId 必然返回 String 测点的标识符。
value 必然返回 Integer/Double/String 测点的数值。

请求内容类型


application/x-www-form-urlencoded

返回内容类型


application/json; charset = UTF-8

请求示例


POST {requestURL}?orgId=yourOrgId
Content-Type: application/x-www-form-urlencoded
Payload: mdmIds=yourMdmId&pointIds=yourPointIds&timeGroup=yourTimeGroup

返回示例


{
    "data": {
        "EL***yP": {
            "INV.a": 2213,
            "INV.b": 2213
        }
    },
    "code": 0,
    "msg": "OK"
}