168 lines
3.4 KiB
Markdown
168 lines
3.4 KiB
Markdown
|
# 任务管理API 接口文档
|
|||
|
|
|
|||
|
|
# 任务管理
|
|||
|
|
|
|||
|
|
# 天风任务-创建任务
|
|||
|
|
url:http://192.168.189.101:8080/jeecg-boot
|
|||
|
|
|
|||
|
|
请求方式：POST
|
|||
|
|
请求路径：/task
|
|||
|
|
|
|||
|
|
# 请求参数
|
|||
|
|
|
|||
|
|
| 参数名 | 必填 | 描述 |
|
|||
|
|
|-------------------|------|--------------------------|
|
|||
|
|
| vwedTaskId | Y | 天风任务 id |
|
|||
|
|
| vwedTaskParentId | Y | 天风任务父级任务 id, 没有就 "" |
|
|||
|
|
| name | Y | 任务名称 |
|
|||
|
|
| isPeriodic | Y | 是否周期任务 |
|
|||
|
|
| priority | Y | 优先级 |
|
|||
|
|
| createTime | Y | 任务创建时间 |
|
|||
|
|
|
|||
|
|
# 请求示例
|
|||
|
|
|
|||
|
|
{
|
|||
|
|
"vwedTaskId": "2129e899-771a-46e2-a484-b655640ea801",
|
|||
|
|
"vwedTaskParentId": "",
|
|||
|
|
"name": "天风任务01",
|
|||
|
|
"isPeriodic": "1",
|
|||
|
|
"priority": "1",
|
|||
|
|
"createTime": "2025-04-08 22:03:57"
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 返回值描述：
|
|||
|
|
|
|||
|
|
| 参数名 | 类型 | 描述 |
|
|||
|
|
|----------|--------|------------------------|
|
|||
|
|
| code | int | 返回状态码（200：成功，400：失败） |
|
|||
|
|
| message | string | 返回消息 |
|
|||
|
|
|
|||
|
|
# 返回示例
|
|||
|
|
|
|||
|
|
成功
|
|||
|
|
|
|||
|
|
{
|
|||
|
|
"success": true,
|
|||
|
|
"message": "success",
|
|||
|
|
"code": 200,
|
|||
|
|
"result": null,
|
|||
|
|
"timestamp": 1741866819647
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
失败
|
|||
|
|
|
|||
|
|
{
|
|||
|
|
"success": false,
|
|||
|
|
"message": "请设置任务优先级",
|
|||
|
|
"code": 401,
|
|||
|
|
"result": null,
|
|||
|
|
"timestamp": 1741866819647
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 天风任务-选择amr
|
|||
|
|
|
|||
|
|
请求方式：POST
|
|||
|
|
|
|||
|
|
请求路径：/task/chooseAmr
|
|||
|
|
|
|||
|
|
# 请求参数
|
|||
|
|
|
|||
|
|
| 参数名 | 必填 | 描述 |
|
|||
|
|
|--------------------|------|--------------------------------|
|
|||
|
|
| vwedTaskId | Y | 天风任务 id |
|
|||
|
|
| keyStationName | Y | 关键站点名称 |
|
|||
|
|
| appointAmrName | N | 指定的 amr 名称，不指定留空 "" |
|
|||
|
|
| appointAmrGroupName| N | 指定的 amr 分组名称，不指定留空 "" |
|
|||
|
|
|
|||
|
|
# 请求示例
|
|||
|
|
|
|||
|
|
{
|
|||
|
|
"vwedTaskId": "2129e899-771a-46e2-a484-b655640ea801",
|
|||
|
|
"keyStationName": "TK01",
|
|||
|
|
"appointAmrName": "",
|
|||
|
|
"appointAmrGroupName": ""
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 返回示例
|
|||
|
|
|
|||
|
|
成功
|
|||
|
|
|
|||
|
|
{
|
|||
|
|
"success": true,
|
|||
|
|
"message": "",
|
|||
|
|
"code": 200,
|
|||
|
|
"result": {
|
|||
|
|
"amrId": "1912349377797406722",//选定的 amrId
|
|||
|
|
"amrName": "1921681102"//选定的 amr 名称
|
|||
|
|
},
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 失败
|
|||
|
|
|
|||
|
|
{
|
|||
|
|
"success": false,
|
|||
|
|
"message": "此任务已封口",
|
|||
|
|
"code": 400,
|
|||
|
|
"result": null,
|
|||
|
|
"timestamp": 1741866819647
|
|||
|
|
}
|
|||
|
|
# 天风任务-添加动作
|
|||
|
|
|
|||
|
|
请求方式：POST
|
|||
|
|
|
|||
|
|
请求路径：/task/addAction
|
|||
|
|
|
|||
|
|
# 请求参数
|
|||
|
|
|
|||
|
|
| 参数名 | 必填 | 描述 |
|
|||
|
|
|--------------|------|--------------|
|
|||
|
|
| vwedTaskId | Y | 天风任务 id |
|
|||
|
|
| stationName | Y | 站点名称 |
|
|||
|
|
| action | Y | 动作 |
|
|||
|
|
|
|||
|
|
# 请求示例
|
|||
|
|
|
|||
|
|
{
|
|||
|
|
"vwedTaskId": "2129e899-771a-46e2-a484-b655640ea801",
|
|||
|
|
"stationName": "PT02",
|
|||
|
|
"action": "JackUnLoad"
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 返回示例
|
|||
|
|
|
|||
|
|
成功
|
|||
|
|
|
|||
|
|
{
|
|||
|
|
"success": true,
|
|||
|
|
"message": "",
|
|||
|
|
"code": 200,
|
|||
|
|
"result": null,
|
|||
|
|
"timestamp": 1745559946174
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 失败
|
|||
|
|
|
|||
|
|
{
|
|||
|
|
"success": false,
|
|||
|
|
"message": "此任务动作已存在",
|
|||
|
|
"code": 400,
|
|||
|
|
"result": null,
|
|||
|
|
"timestamp": 1741866819647
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 天风任务-封口
|
|||
|
|
|
|||
|
|
请求方式：PUT
|
|||
|
|
请求路径：/task/{vwedTaskId}/closure
|
|||
|
|
请求参数: 无
|
|||
|
|
返回示例
|
|||
|
|
|
|||
|
|
{
|
|||
|
|
"success": true,
|
|||
|
|
"message": "",
|
|||
|
|
"code": 200,
|
|||
|
|
"result": null,
|
|||
|
|
"timestamp": 1745559946174
|
|||
|
|
}
|
|||
|
|
|