远程打开格子柜

客户只需传机器编号和管理后台显示的格子编号，系统会定位该格并自行选择设备实际执行地址，然后异步下发开柜指令。

callback_url、client_request_id 为可选参数，可不传；如果传入 callback_url，Android 设备在串口开格子得到成功、失败或超时结果后，会直接向该地址发起一次 JSON POST，不重试、不由后台代回调。client_request_id 会在回调中原样返回，便于客户系统关联自己的请求。回调中的 open_code 是设备实际执行编号（诊断字段）。

参数可通过 JSON body、form 或 query 传入。建议同一次调用只选择一种参数位置；如果同一业务参数（如 jqcode、code、callback_url、client_request_id）同时出现在 query 与 body，且两处值不一致，接口会返回参数冲突，不会继续下发开格子指令。鉴权 token 放在请求头 token。

成功调用请求示例：

Android 回调客户 URL 的成功 JSON 示例：

{
  "event": "box.open.finished",
  "request_no": "OPENBOX2026061708000747564517",
  "client_request_id": "rand-20260617-0001",
  "jqcode": "10339",
  "sn": "b1ed0fa7275e783c",
  "status": "success",
  "code": 200,
  "message": "open box success",
  "box_id": 123,
  "box_code": "1",
  "open_code": 1,
  "action": 5,
  "duration_ms": 850
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

请求参数

请求示例代码

返回响应