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_getBoxList
按机器编号查询授权机器下的格子信息。默认返回该机器全部格子类型,可用 code 查询单个格子,可用 type 过滤一个或多个格子类型。
格子类型枚举:1 私有储物柜,2 公共储物柜,3 借还柜,4 计数/称重借还柜,5 废刀回收柜,6 暂存柜,7 再用柜,8 计数/称重再用柜。
include_stocks=1 时,type=3/4 的格子会返回 stocks 多物品库存明细;其它类型通常没有 stocks。
筛选(可选):除机器和格子本体字段外,可按工单号和机台/CNC 筛选。gdh / work_order_no
匹配当前格子状态或该格子的借用订单记录;lid 精确匹配机台/CNC ID;lname / cnc 按机台/CNC 名称模糊匹配。
当命中来自借用订单记录时,格子行会附带 matched_borrow_order 最近匹配记录摘要;若要判断当前是否仍已领用,优先看格子行当前 gdh / lid / lname,并结合 matched_borrow_order.type 或 borrow_type 筛选区分历史借还记录。

请求参数

Header 参数

Body 参数application/json

示例
{
    "jqcode": "10339",
    "include_stocks": 1,
    "gdh": "GDH-20250717-001"
}

请求示例代码

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/adminapi/openapi_getBoxList' \
--header 'token;' \
--header 'Content-Type: application/json' \
--data '{
    "jqcode": "10339",
    "include_stocks": 1,
    "gdh": "GDH-20250717-001"
}'

返回响应

🟢200
application/json
查询成功
Bodyapplication/json

示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "machine": {
            "mid": 0,
            "jqcode": "string",
            "jqname": "string",
            "organization_id": 0,
            "organization_name": "string",
            "machine_type_id": 0,
            "machine_version": 0
        },
        "boxes": [
            {
                "id": 0,
                "mid": 0,
                "code": 0,
                "fcode": "string",
                "examine_code": "string",
                "action": 0,
                "type": 1,
                "type_name": "string",
                "status": 0,
                "aid": 0,
                "realname": "string",
                "pid": 0,
                "pname": "string",
                "cname": "string",
                "pcode": "string",
                "count": 0,
                "putcount": 0,
                "isBroken": 0,
                "borrowcountmax": 0,
                "borrowcount": 0,
                "borrowwarning": 0,
                "isPortion": 0,
                "portionUsers": "string",
                "ugs": "string",
                "gdh": "string",
                "lid": 0,
                "lname": "string",
                "matched_borrow_order": {},
                "stocks": [
                    {}
                ]
            }
        ]
    }
}
修改于 2026-08-04 05:28:42
上一页
货道补货 / 编辑(与 openapi_saveRoad 相同)
下一页
保存/修改已有格子信息
Built with