触发 RFID 单次读取 - 智能柜开放接口

按机器编号下发 RFID 单次读取命令。后台只负责鉴权、检查机器 RFID 和开放接口开关、下发设备指令。

Android 仅在 grant 页面响应该命令；其他页面会忽略。读取完成后由 Android 直接向 callback_url 发起一次 JSON POST，不重试、不由后台代回调。

本接口必须传 antennas 指定本次读取使用的全局天线编号。
全局天线编号由 PC 端 /machine 页面 RFID 设置维护；例如第二台读写器的 4 根天线可配置为 [5,6,7,8]。
后端会校验传入编号已在该设备上配置并启用。
读写器 IP、端口、读取时长、Q 值、Session 等底层参数仍在 PC 端 RFID 设置里维护，本接口不接收这些参数。
鉴权 token 放在请求头 token，不要传成 Authorization: Bearer <token>。

成功调用请求示例：

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

{
  "event": "rfid_inventory.finished",
  "request_no": "RFID2026061708000747564517",
  "client_request_id": "rand-20260617-0001",
  "jqcode": "10339",
  "sn": "b1ed0fa7275e783c",
  "status": "success",
  "code": 200,
  "message": "RFID inventory success",
  "count": 5,
  "epcs": [
    "E2806894000050334C1171CB",
    "E28068940000401FC453E014",
    "E28068940000401FC453D014",
    "E28068940000401FC4545014",
    "E2806894000040334C1161CB"
  ],
  "tags": [
    { "epc": "E2806894000050334C1171CB", "rssi": 66, "antennas": [5] },
    { "epc": "E28068940000401FC453E014", "rssi": 69, "antennas": [6] },
    { "epc": "E28068940000401FC453D014", "rssi": 79, "antennas": [7] },
    { "epc": "E28068940000401FC4545014", "rssi": 84, "antennas": [8] },
    { "epc": "E2806894000040334C1161CB", "rssi": 69, "antennas": [5,6] }
  ],
  "duration_ms": 15435
}

请求参数

Query 参数

Header 参数

Body 参数

application/json

示例

使用全局天线 5 读取使用第二台读写器的全局天线 5-8 读取

{
    "jqcode": "10339",
    "callback_url": "http://customer.example.com/rfid/callback",
    "client_request_id": "rand-20260617-0001",
    "antennas": [
        5
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

指令已下发

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "request_no": "RFID2026061708000747564517",
        "client_request_id": "rand-20260617-0001",
        "jqcode": "10339",
        "antennas": [
            5,
            6,
            7,
            8
        ],
        "status": "sent"
    }
}

🔴500