累计型测点接口规范


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


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"
}