Files
bj_power/test/AGV-RCS.postman_collection.json
T
SunYF f8482b18f6 feat: 移除工位模板、AGV 链路增强与产品BOM/混产模板完善
- 移除工位模板体系(handler/logic 全删),同步路由与 seed
- AGV 链路增强:点位锁、车辆状态、退料派车调整,新增海康 RCS Postman 调试集合
- MES 产品BOM/混产模板完善:新增 ProductBOMDialog 组件,调整 handler/logic;日排产达成对比调整
- WMS 业务完善:出入库、检验、备料、退料、成品入库、缺料代报等 handler 与前端页面调整
- 前端通用:双端新增 RemotePageSelect 组件,统一 nextStep 规则/帮助文档/布局/请求拦截
- 文档:更新产线API/案例/部署手册/问题记录等
2026-11-18 09:53:42 +08:00

247 lines
14 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"info": {
"name": "海康 AGV RCS-Lite 原接口(直连 192.168.22.13:8182)",
"description": "海康 RCS-Lite v1.5 原始 API 直连,不经过 MES。\n\n== 点位编号全部取自 MES 数据库种子数据(【AGV管理】接驳台状态/点位管理页同源) ==\n产线接驳台:DOCK01(工位1左)/ DOCK02(工位1右)/ DOCK03(工位2右)/ DOCK04(工位2左)/ DOCK05~DOCK20(工位3~10 左右)\n工位接驳台(GW 系列):GW1Z 工位1左 / GW1Y 工位1右 / GW2Z / GW2Y / … / GW10Z / GW10Y\n库房收货接驳台:JBT21\n虚拟点位:XW 线尾 / XT 线头 / KF1 库房 / A1~A4\n车辆位:AGV-CHARGE01 充电位 / AGV-WAIT01、AGV-WAIT02 待命位\n\n实测状态:JBT21、XW、XT 已在 MES 日志中下发成功(RCS 认);GW 系列、DOCK 系列以 RCS 后台实际配置为准,报「位置编号不存在」= RCS 后台还没配该点。\n\n== 三条硬规则(都踩过) ==\n1. 任务接口路径是小写 rcms:/rcms/services/rest/hikRpcService/...,大写 rCMS 会 404。\n2. reqCode 长度 ≤32 且每次唯一({{$guid}} 是 36 位会被拒:「reqCode输入的值长度不符合规范」),本集合统一用 PM{{$timestamp}}。\n3. 车辆状态走另一服务 /rcms-dps/rest/queryAgvStatus,mapShortName 必填 2 位地图简称:传空回「mapShortName必填项不能为空」,传错回「地图编号不存在」。已确认真实简称=AA(RCS 后台截图地码类型 + MES 日志实测 AA 通过地图校验)。缺 robotCount 会回「robots robotCount同时为空」,请求里已带 robotCount=-1。",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"variable": [
{ "key": "host", "value": "http://192.168.22.13:8182", "type": "string" },
{ "key": "mapShortName", "value": "AA", "type": "string" },
{ "key": "taskCode", "value": "", "type": "string" },
{ "key": "agvCode", "value": "9001", "type": "string" }
],
"item": [
{
"name": "1 派车 genAgvSchedulingTask",
"item": [
{
"name": "1-1 C01 空车接货 → JBT21(单到达点,不举升)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMC01{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskTyp\": \"C01\",\n \"taskCode\": \"PMC01{{$timestamp}}\",\n \"priority\": \"1\",\n \"positionCodePath\": [\n { \"positionCode\": \"JBT21\", \"type\": \"00\" }\n ]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/genAgvSchedulingTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "genAgvSchedulingTask"]
},
"description": "C01 空车接货:只给到达点 JBT21(库房收货接驳台),不举升、不指定车,车到位停住等人选下一站。MES 日志实测下发成功过。"
}
},
{
"name": "1-2 B01 举升 JBT21 → GW1Z(两点)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMB01{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskTyp\": \"B01\",\n \"taskCode\": \"PMB01{{$timestamp}}\",\n \"priority\": \"1\",\n \"podCode\": \"\",\n \"positionCodePath\": [\n { \"positionCode\": \"JBT21\", \"type\": \"00\" },\n { \"positionCode\": \"GW1Z\", \"type\": \"00\" }\n ]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/genAgvSchedulingTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "genAgvSchedulingTask"]
},
"description": "B01 举升:起点 JBT21 + 终点 GW1Z(工位1左接驳台)。终点可换种子数据里任意点位:GW1Y~GW10Y/GW10Z、DOCK01~DOCK20。\n报「位置编号不存在」= RCS 后台没配该点,换 RCS 后台确认过的位置编号。\npodCode 填托盘/货架号,留空=RCS 自己找。真举升,先确认车上没货。"
}
},
{
"name": "1-3 B01 举升 + 指定车(agvCode 锁车)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMB01L{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskTyp\": \"B01\",\n \"taskCode\": \"PMB01L{{$timestamp}}\",\n \"priority\": \"1\",\n \"agvCode\": \"{{agvCode}}\",\n \"positionCodePath\": [\n { \"positionCode\": \"GW1Z\", \"type\": \"00\" },\n { \"positionCode\": \"GW2Z\", \"type\": \"00\" }\n ]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/genAgvSchedulingTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "genAgvSchedulingTask"]
},
"description": "带 agvCode 即指定车执行(人工派车链二段锁车就是这个字段)。车号从 queryAgvStatus 的 robotCode 拿。"
}
},
{
"name": "1-4 B02 移动 XW → XT(两点,不举升)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMB02{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskTyp\": \"B02\",\n \"taskCode\": \"PMB02{{$timestamp}}\",\n \"priority\": \"1\",\n \"positionCodePath\": [\n { \"positionCode\": \"XW\", \"type\": \"00\" },\n { \"positionCode\": \"XT\", \"type\": \"00\" }\n ]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/genAgvSchedulingTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "genAgvSchedulingTask"]
},
"description": "B02 移动:XW 线尾 → XT 线头(种子数据虚拟点位,实测下发成功过)。报 1006「站点集合传的数量不对」= B02 模板期望点位数与传的不一致。"
}
}
]
},
{
"name": "2 查询",
"item": [
{
"name": "2-1 查任务状态(按 taskCode)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMQ{{$timestamp}}\",\n \"reqTime\": \"\",\n \"agvCode\": \"\",\n \"taskCodes\": [\"{{taskCode}}\"]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/queryTaskStatus",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "queryTaskStatus"]
},
"description": "taskCodes 填派车时的 taskCode。taskStatus:1 已创建 / 2 正在执行 / 5 取消完成 / 9 已结束。\nagvCode 空不代表没派车(RCS-Lite 经常不回车号),车号看 queryAgvStatus。"
}
},
{
"name": "2-2 查任务状态(按 agvCode)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMQA{{$timestamp}}\",\n \"reqTime\": \"\",\n \"agvCode\": \"{{agvCode}}\"\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/queryTaskStatus",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "queryTaskStatus"]
},
"description": "agvCode 非空时按车查历史任务。"
}
},
{
"name": "2-3 查车辆状态 queryAgvStatus(rcms-dps,mapShortName 必填)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMV{{$timestamp}}\",\n \"reqTime\": \"\",\n \"mapShortName\": \"{{mapShortName}}\",\n \"robotCount\": \"-1\"\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms-dps/rest/queryAgvStatus",
"host": ["{{host}}"],
"path": ["rcms-dps", "rest", "queryAgvStatus"]
},
"description": "路径 rcms-dps/rest。mapShortName 已确认=AA(2026-11-17 RCS 后台截图地码类型 + MES 日志实测:AA 通过地图校验、其余候选全回「地图编号不存在」)。缺 robotCount 回「robots robotCount同时为空」,已补 robotCount=-1 查全部。返回 code:0 且 data 有车即成功。"
}
}
]
},
{
"name": "3 任务控制",
"item": [
{
"name": "3-1 取消任务 cancelTask",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMX{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskCode\": \"{{taskCode}}\",\n \"forceCancel\": \"0\"\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/cancelTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "cancelTask"]
},
"description": "taskCode 与 agvCode 二选一,都传优先 agvCode。forceCancel:0=货架放地上;1=背着货架回库(仅潜伏车)。"
}
},
{
"name": "3-2 继续任务 continueTask",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMCT{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskCode\": \"{{taskCode}}\"\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/continueTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "continueTask"]
},
"description": "让暂停/停在半路的任务继续执行。"
}
},
{
"name": "3-3 释放 AGV freeRobot",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMF{{$timestamp}}\",\n \"reqTime\": \"\",\n \"robotCount\": \"1\",\n \"mapShortName\": \"{{mapShortName}}\",\n \"robots\": [\"{{agvCode}}\"]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/freeRobot",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "freeRobot"]
},
"description": "释放指定车。robotCount=-1 表示全部(此时 mapShortName 必填)。"
}
},
{
"name": "3-4 停止 AGV stopRobot",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMST{{$timestamp}}\",\n \"reqTime\": \"\",\n \"robotCount\": \"1\",\n \"mapCode\": \"{{mapShortName}}\",\n \"robots\": [\"{{agvCode}}\"]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/stopRobot",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "stopRobot"]
},
"description": "停止指定车或全部(robotCount=-1)。注意字段名是 mapCode。"
}
},
{
"name": "3-5 恢复 AGV resumeRobot",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMRS{{$timestamp}}\",\n \"reqTime\": \"\",\n \"robotCount\": \"1\",\n \"mapCode\": \"{{mapShortName}}\",\n \"robots\": [\"{{agvCode}}\"]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/resumeRobot",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "resumeRobot"]
},
"description": "恢复后继续执行未完成任务。"
}
}
]
}
]
}