手动完成动作块
接口介绍
通过以下 API来通知 RDSCore手动完成 AGV当前的运单。
注意：手动完成当前的运单指的是运单（order）中的动作块（block），手动完成的是单个动作块，并不是手动完成整个运单。
注意：只有当当前运单处于错误状态，或者 AGV有报错时，才能执行手动完成当前的运单。
请求
- 功能：手动完成动作块
- 方法：
POST - 接口说明：
/manualFinished
json
POST "http://host:8088/manualFinished"
1
请求数据
手动完成运单有两种形式：
针对普通车的手动完成
| Name | Type | Description | Required |
|---|---|---|---|
| vehicles | string array | 需要手动完成动作的车名数组 | 是 |
因为料箱车手动完成 block 时会涉及到，需要将货物从货架放入料箱或需要将货物从料箱放入货架，所以在针对料箱车手动完成运单时，需要传入额外的参数告知料箱车货物的绑定情况。
针对料箱车的手动完成
因为料箱车手动完成 block 时会涉及到，需要将货物从货架拿上料箱或者需要将货物从料箱放入货架，所以在针对料箱车手动完成运单时，需要传入额外的参数告知料箱车货物的绑定情况。
| Name | Type | Description | Required |
|---|---|---|---|
| vehicles | object array | 需要手动完成运单的车名数组和料箱号，其中每个 object 为一个料箱车需要的所有信息，详情见 vehicles 数据结构说明 | 是 |
vehicles 数据结构说明
| Name | Type | Description | Required |
|---|---|---|---|
| name | string | 机器人名 | 是 |
| containerName | string | 料箱名 | 是 |
请求示例
手动完成普通车当前的动作块
python
{
"vehicles": ["car1", "car2"] // 车名数组
}
1
2
3
2
3
手动完成料箱车当前的动作块
json
{
"vehicles": [{
"name": "car1", // 车名
"containerName":"1" // 料箱名称
}, {
"name": "car2", // 车名
"containerName":"1" // 料箱名称
}]
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
收到该请求后，RDSCore将手动完成特定料箱车当前的动作块，并且当运单为 Load 时，将对应货物 id 绑定到对应的containerName上。
响应
响应数据
| Name | Type | Description |
|---|---|---|
| code | int | API 错误码，详情见 API 错误码 |
| msg | string | API 错误码信息 |
| create_on | string | API 上传时间戳 |
响应数据示例
Responses Code 200
成功响应
json
{
"code": 0,
"create_on": "2022-02-10T18:21:25.073Z",
"msg": "ok"
}
1
2
3
4
5
2
3
4
5
Responses Code 400
vehicles 不为 string array
json
{
"code": 50001,
"create_on": "2022-05-18T16:04:48.878Z",
"msg": "vehicles array invalid"
}
1
2
3
4
5
2
3
4
5
vehicles 不为 array
json
{
"code": 50001,
"create_on": "2022-05-18T16:05:18.897Z",
"msg": "vehicles must be array"
}
1
2
3
4
5
2
3
4
5
请求数据不为 json
json
{
"code": 50000,
"create_on": "2022-05-18T16:06:02.908Z",
"msg": "parse json error"
}
1
2
3
4
5
2
3
4
5
Responses Code 406
RDSCore 没有 XXX 机器人控制权
json
{
"code": 50003,
"create_on": "2022-05-18T16:06:36.029Z",
"msg": "vehicle XXX not locked"
}
1
2
3
4
5
2
3
4
5
最近更新 2022/11/28
感谢反馈有用
感谢反馈没用
