帮助中心
帮助中心主页
HTTP API
Modbus API
常见问题
手动完成动作块

接口介绍

通过以下 API来通知 RDSCore手动完成 AGV当前的运单。

注意:手动完成当前的运单指的是运单(order)中的动作块(block),手动完成的是单个动作块,并不是手动完成整个运单。

注意:只有当当前运单处于错误状态,或者 AGV有报错时,才能执行手动完成当前的运单。

请求

  • 功能:手动完成动作块
  • 方法:POST
  • 接口说明:/manualFinished
json
POST "http://host:8088/manualFinished"
1

请求数据

针对普通车的手动完成

NameTypeDescriptionRequired
vehiclesstring array需要手动完成动作的车名数组

因为料箱车手动完成 block 时会涉及到,需要将货物从货架放入料箱或需要将货物从料箱放入货架,所以在针对料箱车手动完成运单时,需要传入额外的参数告知料箱车货物的绑定情况。

针对料箱车的手动完成

因为料箱车手动完成 block 时会涉及到,需要将货物从货架拿上料箱或者需要将货物从料箱放入货架,所以在针对料箱车手动完成运单时,需要传入额外的参数告知料箱车货物的绑定情况。

NameTypeDescriptionRequired
vehiclesobject array需要手动完成运单的车名数组和料箱号,其中每个 object 为一个料箱车需要的所有信息,详情见 vehicles 数据结构说明

vehicles 数据结构说明
NameTypeDescriptionRequired
namestring机器人名
containerNamestring料箱名

请求示例

手动完成普通车当前的动作块

python
{
    "vehicles": ["car1", "car2"]	// 车名数组
}
1
2
3

手动完成料箱车当前的动作块

json
{
    "vehicles": [{
        "name": "car1",			// 车名
        "containerName":"1"		// 料箱名称
    }, {
        "name": "car2",			// 车名
        "containerName":"1"		// 料箱名称
    }]
}
1
2
3
4
5
6
7
8
9

收到该请求后,RDSCore将手动完成特定料箱车当前的动作块,并且当运单为 Load 时,将对应货物 id 绑定到对应的containerName上。

响应

响应数据

NameTypeDescription
codeintAPI 错误码,详情见 API 错误码
msgstringAPI 错误码信息
create_onstringAPI 上传时间戳

响应数据示例

Responses Code 200

成功响应
json
{
    "code": 0,
    "create_on": "2022-02-10T18:21:25.073Z",
    "msg": "ok"
}
1
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

vehicles 不为 array
json
{
    "code": 50001,
    "create_on": "2022-05-18T16:05:18.897Z",
    "msg": "vehicles must be array"
}
1
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

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
最近更新 2022/11/28
文章内容

接口介绍

请求

请求数据

针对普通车的手动完成

针对料箱车的手动完成

请求示例

手动完成普通车当前的动作块

手动完成料箱车当前的动作块

响应

响应数据

响应数据示例

Responses Code 200

Responses Code 400

Responses Code 406