历史服务接口

版本记录

历史服务

1、多测点历史原始值查询 :id=one

请求方法

POST /v1/history/findAll

请求参数

响应参数

异常处理

请求示例

POST/v1/history/findAll

{
    "startTime": "2023-03-14 13:40:30",
    "endTime": "2023-03-14 15:15:30",
    "nodeIds": [
        "100:EQ_001.AI_002.PV"
    ],
    "pageable":{
        "page":1,
        "pagesize":500
    }
}

响应示例

{
	"data": [
		{
			"data": [
				{
					"q": 0,
					"t": 0,
					"v": {}
				}
			],
			"nodeId": "",
			"total": 0
		}
	],
	"message": "",
	"code": 0,
	"timestamp": 0
}

2、测点多点项聚合查询 :id=two

请求方法

POST /v1/history/findAggregate

请求参数

响应参数

异常处理

请求示例

POST /v1/history/findAggregate

{
    "startTime": "2023-04-03 15:22:30",
    "endTime": "2023-04-03 15:27:30",
    "func": "decrement",
    "nodeIds": [
        "100:model0.AI_TAG0.AV","100:model0.AI_TAG1.AV"
    ]
}

响应示例

{
  "code": 0,
  "message": "操作成功",
  "data": {
    "100:model0.AI_TAG0.AV": 1.24937445,
    "100:model0.AI_TAG1.AV": 1.24937445
  },
  "timestamp": 1680831764398
}

3、历史趋势数据查询 :id=three

请求方法

POST /v1/history/findAllSection

请求参数

响应参数

异常处理

请求示例

POST/v1/history/findAllSection

 {
    "complementFunc": 0,
    "startTime": "2023-04-03 15:22:30",
    "endTime": "2023-04-03 15:27:30",
    "includeBounds": true,
    "interval": 3000,
    "nodeIds": [
        "100:model0.AI_TAG0.AV","100:model0.AI_TAG1.AV"
    ]
}

响应示例

{
	"code": 0,
	"message": "",
	"data": [
		{
			"data": [
				{
					"q": 0,
					"st": 0,
					"t": 0,
					"v": {}
				}
			],
			"nodeId": "",
			"total": 0
		}
	],
	"timestamp": 0
}

4、指定时间范围内的历史回放数据查询 :id=four

请求方法

POST /v1/history/findDataBySection

请求参数

响应参数

异常处理

请求示例

POST/v1/history/findDataBySection

{
    "complementFunc": 0,
    "startTime": "2023-04-03 15:22:30",
    "endTime": "2023-04-03 15:27:30",
    "includeBounds": true,
    "interval": 1000,
    "nodeIds": [
        "100:model0.AI_TAG0.AV"
    ]
}

响应示例

{
    "code": 0,
    "message": "操作成功",
    "data": [
        {
            "data": [
                {
                    "q": 0,
                    "t": 0,
                    "v": 0.34202015
                }
            ],
            "nodeId": "100:model0.AI_TAG0.AV",
            "total": 16
        }
    ],
    "timestamp": 1680833438495
}

5、多测点分段历史聚合查询 :id=five

请求方法

POST /v1/history/findAggregateSection

请求参数

响应参数

异常处理

请求示例

POST/v1/audit/log/find

{
    "startTime": "2023-05-10 09:07:00",
    "endTime": "2023-05-10 09:09:00",
    "func": "min",
    "includeBounds": true,
    "interval": 3000,
    "complementFunc":0,
    "nodeIds": [
        "100:model0.AI_TAG0.AV"
    ]
}

响应示例

{
    "code": 0,
    "message": "操作成功",
    "data": {
        "100:model0.AI_TAG0.AV": [
            {
                "q": 0,
                "t": 1683680820000,
                "v": 0.017452406
            },
            {
                "q": 0,
                "t": 1683680823000,
                "v": 0.017452406
            }
        ]
    },
    "timestamp": 1684120106219
}

6、曲线拟合历史查询 :id=six

请求方法

POST /v1/history/findDegreeOfFitting

请求参数

响应参数

异常处理

请求示例

POST /v1/history/findDegreeOfFitting

{
    "endTime": "2023-06-28 10:05:00",
    "startTime": "2023-06-28 10:00:00",
    "includeBounds": true,
    "interval": 1000,
    "complementFunc":0
    "nodeIds": [
        "100:model0.AI_TAG0.AV"
    ]
}

响应示例

{
    "code": 0,
    "message": "操作成功",
    "data": {
        "100:model0.AI_TAG0.AV": [
            {
                "q": 0,
                "t": 1687917600000,
                "v": -0.40257028519174054
            },
            {
                "q": 0,
                "t": 1687917601000,
                "v": -0.39073113
            }
        ]
    },
    "timestamp": 1687921609097
}

7、计算点项的某个值在指定时间范围内所占时长 :id=seven

请求方法

POST /v1/history/statisticsDataTime

请求参数

响应参数

异常处理

请求示例

POST/v1/history/statisticsDataTime

{
    "startTime": "2023-07-19 17:30:00",
    "endTime": "2023-07-19 17:35:00",
    "nodeIds": [
        "998:model0.AI_TAG0.AV",
        "998:model0.AI_TAG1.AV"
    ],
    "value":777
}

响应示例

{
    "code": 0,
    "message": "操作成功",
    "data": [
        {
            "nodeId": "998:model0.AI_TAG0.AV",
            "totalTime": 229
        },
        {
            "nodeId": "998:model0.AI_TAG1.AV",
            "totalTime": 232
        }
    ],
    "timestamp": 1690251845980
}

8、多测点历史 string 类型原始值查询 :id=eight

请求方法

POST /v1/history/findAllString

请求参数

响应参数

异常处理

请求示例

POST/v1/history/findAllString

{
    "startTime": "2023-03-14 13:40:30",
    "endTime": "2023-03-14 15:15:30",
    "nodeIds": [
        "100:EQ_001.AI_002.PV"
    ],
    "pageable":{
        "page":1,
        "pagesize":500
    }
}

响应示例

{
    "code": 0,
    "message": "操作成功",
    "data": [
        {
            "data": [
                {
                    "q": 0,
                    "t": 1689672029363,
                    "v": "0.034899496"
                },
                {
                    "q": 0,
                    "t": 1689672031479,
                    "v": "0.052335955"
                }
            ],
            "nodeId": "100:EQ_001.AI_002.PV",
            "total": 25
        }
    ],
    "timestamp": 1690252915316
}

9、多测点历史时刻点查询 :id=nine

请求方法

POST /v1/history/findTimes

请求参数

响应参数

异常处理

请求示例

POST/v1/history/findTimes

{
    "dateTimes": [
        "1695696145665",
        "1695696219000",
        "1695712706584"

    ],
    "nodeIds": [
        "999:model0.AI_TAG0.AV",
        "999:model0.AI_TAG1.AV",
        "200:model0.AI_TAG0.AV",
        "200:model0.AI_TAG1.AV"
    ]
}

响应示例

{
    "code": 0,
    "message": "操作成功",
    "data": [
        {
            "data": [
                {
                    "q": 0,
                    "t": 1695696145334,
                    "v": 777.0
                }
            ],
            "nodeId": "999:model0.AI_TAG1.AV",
            "total": 1
        },
        {
            "data": [
                {
                    "q": 0,
                    "t": 1695696145334,
                    "v": 777.0
                }
            ],
            "nodeId": "999:model0.AI_TAG0.AV",
            "total": 1
        },
        {
            "data": [
                {
                    "q": 0,
                    "t": 1695712706947,
                    "v": 0.052335955
                }
            ],
            "nodeId": "200:model0.AI_TAG0.AV",
            "total": 1
        }
    ],
    "timestamp": 1695712759542
}

10、历史最近 n 条记录查询 :id=ten

请求方法

POST /v1/history/ findLatest

请求参数

响应参数

异常处理

请求示例

POST /v1/history/ findLatest

{
    "dateTime": "2023-11-02 15:30:00",
    "forward": true,
    "size": 20,
    "nodeIds": [
        "125:model0.AI_TAG0.AV",
        "125:model0.AI_TAG1.AV"
    ]
}

响应示例

{
    "code": 0,
    "message": "操作成功",
    "data": {
        "125:model0.AI_TAG0.AV": [
            {
                "q": 0,
                "t": 1698909396822,
                "v": 0.98162717
            }
        ],
        "125:model0.AI_TAG1.AV": [
            {
                "q": 0,
                "t": 1698909398840,
                "v": 0.9848077
            }
        ]
    },
    "timestamp": 1698909667204
}

11、历史时序数据写入 :id=eleven

请求方法

POST /v1/history/write

请求参数

响应参数

异常处理

请求示例

POST /v1/history/write

{
		"namespace":"hsmos3",
		"datas": [
			{
				"nodeId": "model1.model11.COUNTER13_1.AV",
				"t": 1678167000000,
                "v": 0.484453105688888888,
                "q": 0,
                "st": 1678167000000
			},
            {
				"nodeId": "model1.model11.COUNTER13_2.AV",
                "t": 1678167000000,
                "v": 0.484453105688888888,
                "q": 0,
                "st": 1678167000000
			}
		]
	}

响应示例

{
    "code": 0,
    "message": "写入成功",
    "timestamp": 1701308327721,
    "data": true
}