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 发起）
      POST
    • 客户系统接收：借还工单查询（Android 发起）
      POST
    • 【Webhook 说明】货道变动推送（智能柜→客户）
      POST
    • 【Webhook 说明】订单状态推送（智能柜→客户）
      POST
    • 【Webhook 说明】借用订单状态推送（智能柜→客户）
      POST
  • 未开放
    • 调接口传数据给mes系统（刀具柜系统发起）
  • 报表统计
    • 售货机报表查询
    • 库存变动统计查询
    • 库存变动统计（精简，无期初/期末）
  • 机台
    • 查询机台
    • 修改机台
  • 数据模型
    • 操作成功
    • OpenApiOutRoadRequest
  1. 事件推送

【Webhook 说明】货道变动推送（智能柜→客户）

POST
/_documentation/webhook-road-history
本文档项不是智能柜服务端接口。 智能柜在货道库存变化时，向客户在总机构配置的 URL 主动 POST（application/x-www-form-urlencoded）。

启用条件（总机构 type=0）#

subscribe_notify_enable = 1
subscribe_road_notify_url 非空
do_type 在 subscribe_road_notify_do_types 列表中（如 1,2,3,4）

推送字段（当前实现）#

字段说明
idroad_history 记录 ID
creattime变动时间
do_type1售出 2变更 3上架 4下架
change_num变化数量
beforestock / afterstock变化前/后库存
road_num货道号
pid / pname / pcode商品信息
jqcode / mname机器信息
realname操作人
user_id操作人公开人员 ID（admin.id）
uid历史操作人关联 ID（road_history.uid），保留兼容，不建议作为公开人员 ID
orderid订单 ID（order.id）
mid / moid机器/总机构 ID

与工单（openapi_saveReceive）的关联 ⚠️#

orderid 不是 工单 ID
领刀出货时：设备创建 order（type=6），并设置 order.order_receive_id 指向工单
明细 order_detailed.receive_goods_id 指向工单明细
货道 Webhook 未推送 order_receive_id、receive_goods_id、gdsl、proNumber（请用 订单状态 Webhook，v1.0.4+ 已含工单字段）
客户若仅订阅货道 Webhook，仍需用 orderid 间接关联，或轮询 openapi_getRoadHis / openapi_orderIndex

请求参数

Body 参数application/x-www-form-urlencoded

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.gdlykj.com/_documentation/webhook-road-history' \
--data-urlencode 'orderid=' \
--data-urlencode 'do_type=1' \
--data-urlencode 'road_num=' \
--data-urlencode 'jqcode=' \
--data-urlencode 'pname=' \
--data-urlencode 'user_id=' \
--data-urlencode 'uid=' \
--data-urlencode 'change_num='

返回响应

🟢200
客户 URL 应返回 HTTP 200 表示接收成功
该响应没有 Body
修改于 2026-07-22 03:36:29
上一页
客户系统接收：借还工单查询（Android 发起）
下一页
【Webhook 说明】订单状态推送（智能柜→客户）
Built with