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_saveCategory
同一接口按参数区分三种操作:
操作cidstatus必填参数
新增不传或 ≤0不传或 1cname;picture 可选(不传默认 /system/logo.png)
编辑分类 ID1cname
删除分类 ID-1分类下不能有在用商品
picture(分类图片)
相对路径(如 /upload/xxx.png)或完整 URL(http 开头且为本系统 OSS 域名时,会去掉域名前缀后存相对路径)
新增时不传则默认 /system/logo.png(与后台管理端一致)
编辑时不传 picture 则不修改原图;传了则更新
不会将外链图片下载转存 OSS,仅保存传入的路径/URL 字符串
删除失败:若分类下仍有商品,返回「该分类下存在物品,请将该分类下的物品删除后再删除分类」。

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.gdlykj.com/adminapi/openapi_saveCategory?cname=%E6%B5%8B%E8%AF%95%E5%88%86%E7%B1%BB&cid=0&mes_cid=A-1&picture=%2Fsystem%2Flogo.png&status=1' \
--header 'token: 49895b412b4a87517f97ba31f1934a8f'

返回响应

🟢200
application/json
code=200 成功;code=500 业务错误(msg 为原因)
Bodyapplication/json

示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "cid": 172
    }
}
修改于 2026-07-07 09:22:14
上一页
获取商品列表
下一页
新增/编辑/删除商品
Built with