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_saveBox
保存授权机器下一个已有格子的业务信息。接口只更新已有格子,不新增、不删除、不重排格子。旧 /adminapi/openapi_saveBoxType 仅保留为兼容别名,主路径请使用本接口。
定位方式:传 id,或传 jqcode + code;也可传 mid + code。如果同时传 id 与 jqcode/code/mid,必须指向同一个格子,否则返回参数不匹配。
type 可选;不传时沿用当前格子类型,只更新本次传入字段。传入时支持:1 私有储物柜,2 公共储物柜,3 借还柜,4 计数/称重借还柜,5 废刀回收柜,6 暂存柜,7 再用柜,8 计数/称重再用柜。切换类型会按后台 /adminapi/saveBox 的核心规则清理相关字段,例如切到普通储物柜会清空商品,切到公共储物柜会清空占用人,切到 3/4 会维护单物品 box_stock。
可用人限制:不传 isPortion 不修改现有限制;isPortion=0 清空 portionUsers/ugs;isPortion=1 时 portionUsers 和 ugs 至少一个非空。aid/portionUsers 必须是目标机器可见的启用后台用户且排除 authid=75;ugs 必须是目标机器所属机构启用用户组。type=6/7/8 不保存可用人限制,切换到这些类型会清空限制。
7 与 8 仍保持后台业务约束:同一台机器不能同时配置再用柜和计数再用柜。

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "jqcode": "10339",
    "code": 1,
    "isPortion": 1,
    "portionUsers": [
        123
    ],
    "ugs": [
        5
    ]
}

请求示例代码

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_saveBox' \
--header 'token;' \
--header 'Content-Type: application/json' \
--data '{
    "jqcode": "10339",
    "code": 1,
    "isPortion": 1,
    "portionUsers": [
        123
    ],
    "ugs": [
        5
    ]
}'

返回响应

🟢200
application/json
保存成功;非授权机器、无效类型、非法用户/用户组/商品、参数不匹配、7/8 冲突会返回错误
Bodyapplication/json

示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "id": 0,
        "jqcode": "string",
        "code": 0,
        "old_type": 0,
        "old_type_name": "string",
        "type": 0,
        "type_name": "string",
        "action": "string",
        "aid": 0,
        "pid": 0,
        "count": 0,
        "putcount": 0,
        "isPortion": 0,
        "portionUsers": "string",
        "ugs": "string",
        "stocks": [
            {}
        ]
    }
}
修改于 2026-08-04 05:28:42
上一页
查询格子柜格子信息
下一页
远程弹簧货道直出
Built with