1. 设备与货道
智能柜开放接口
  • 认证
    • 登录
      POST
    • 登录验证
      POST
  • 机构
    • 获取机构列表
      POST
    • 添加机构
      POST
    • 编辑机构
      POST
    • 删除机构
      POST
    • 获取人员列表
      POST
    • 添加人员
      POST
    • 编辑人员
      POST
    • 删除人员
      POST
    • 后台用户列表
      POST
  • 商品库
    • 获取分类列表
      POST
    • 获取商品列表
      POST
    • 新增/编辑/删除分类
      POST
    • 新增/编辑/删除商品
      POST
    • 删除商品
      POST
  • 设备与货道
    • 获取机器列表
      POST
    • 获取货道库存信息
      POST
    • 货道补货 / 编辑货道商品
      POST
    • 货道补货 / 编辑（与 openapi_saveRoad 相同）
      POST
    • 查询格子柜格子信息
      POST
    • 保存/修改已有格子信息
      POST
    • 远程弹簧货道直出
      POST
    • 触发 RFID 单次读取
      POST
    • 远程打开格子柜
      POST
    • 修改机器基本信息
      POST
    • 格子记录
      POST
    • 库存变动记录（主动查询）
      POST
  • 订单
    • 获取订单列表
    • 获取借用订单
  • 工单
    • 新增/编辑领料工单
  • 事件推送
    • 客户系统接收：领用工单查询（Android 发起）
    • 客户系统接收：借还工单查询（Android 发起）
    • 【Webhook 说明】货道变动推送（智能柜→客户）
    • 【Webhook 说明】订单状态推送（智能柜→客户）
    • 【Webhook 说明】借用订单状态推送（智能柜→客户）
  • 未开放
    • 调接口传数据给mes系统（刀具柜系统发起）
  • 报表统计
    • 售货机报表查询
    • 库存变动统计查询
    • 库存变动统计（精简，无期初/期末）
  • 机台
    • 查询机台
    • 修改机台
  • 数据模型
    • 操作成功
    • OpenApiOutRoadRequest
  1. 设备与货道

货道补货 / 编辑货道商品

POST
/adminapi/openapi_saveRoad
补刀（货道补货）开放接口，与 PC 后台 /adminapi/saveRoad 完全相同（同一实现、同一参数）。
也可调用 /adminapi/saveRoad，请求头同样携带开放 API 的 token 即可。

典型补货流程#

1.
openapi_roadIndex（可传 jqcode）获取货道：rid、pid、stock、maxstock、price
2.
计算目标库存：stock = 当前库存 + 补入数量（绝对值，非增量参数）
3.
调用本接口，pid 保持与货道当前商品一致，仅提高 stock（maxstock、price 一般保持不变）

参数说明#

参数必填说明
id是货道 ID，即 openapi_roadIndex 返回的 rid
pid是商品 ID；纯补货时与当前货道 pid 相同
stock是目标库存（补货后的绝对数量，不是增量）
maxstock是最大库存
price是售价（分）
sku否规格系数，默认 1

副作用#

写入 road_history（同商品仅改库存时 do_type=2；新上架 do_type=3；换货下架 do_type=4）
若机构配置了货道 Webhook，补货会触发推送
通知设备刷新商品列表

与结构调整的区别#

openapi_saveRoad：改货道当前库存/商品/价格（补货）
货道结构、编号和容量调整属于工厂端维护能力，不在客户导入文档中开放

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.gdlykj.com/adminapi/openapi_saveRoad?id=10001&pid=606&stock=20&maxstock=30&price=100&sku=undefined' \
--header 'token;'

返回响应

🟢200
application/json
code=200 修改成功；code=500 业务错误（如不能超过最大库存）
Bodyapplication/json

示例
{
    "code": 200,
    "msg": "修改成功"
}
修改于 2026-07-07 09:22:14
上一页
获取货道库存信息
下一页
货道补货 / 编辑（与 openapi_saveRoad 相同）
Built with