远程弹簧货道直出

按机器编号和管理后台显示的货道编号，直接向领业设备下发弹簧货道出货指令。本接口只执行硬件动作，不创建订单、不扣减库存、不写货道流水；商品为空或库存为零不会阻止执行。

count 为出货数量，范围 1～10。设备会逐件串行转动，当前一件确认成功后才执行下一件；任意一次失败或超时都会停止。transfer_to_outlet=true 时，仅在全部转动成功后把该柜物料传送到出货口。

设备串口正忙时直接拒绝本次请求，不排队。client_request_id 只在结果回调中原样返回，不参与防重或幂等判断；重复提交相同值仍会产生新的 request_no 并重新出货。

参数可通过 JSON body、form 或 query 传入。同一字段同时出现在 query 与 body 且值不一致时，接口会拒绝，不下发设备指令。传入 callback_url 时，设备在最终完成后直接向该地址发起一次 JSON POST，不重试；不传则不产生结果回调。

成功调用请求示例：

设备结果回调示例：

{
  "event": "road.dispense.finished",
  "request_no": "OUTROAD2026081108300012345678",
  "client_request_id": "road-20260811-0001",
  "jqcode": "10339",
  "sn": "b1ed0fa7275e783c",
  "road_id": 456,
  "road_code": "11",
  "physical_code": 2,
  "requested_count": 2,
  "attempted_count": 2,
  "successful_turns": 2,
  "suspect_turns": 0,
  "transfer_requested": true,
  "transfer_status": "success",
  "status": "success",
  "code": 200,
  "message": "road dispense and transfer success",
  "failure_stage": "",
  "duration_ms": 3260
}

{ "jqcode": "10339", "code": 11, "count": 1, "transfer_to_outlet": false, "callback_url": "https://customer.example.com/road/callback", "client_request_id": "road-20260811-0001" }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

指令已下发；callback_url 的最终事件为 road.dispense.finished，status 为 success、partial、failed、timeout 或 busy

该响应没有 Body

请求参数

请求示例代码

返回响应