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_saveProduct
同一接口按参数区分三种操作:
操作pidstatus说明
新增不传1 或不传需传 cid、pname
编辑商品 ID1可改名称、分类、图片等
删除商品 ID-1商品不能被货道引用
picture(商品图片)
新增时不传或传空则继承所属分类的 pic;编辑时不传则保留原图
继承后仍为空时,新增默认 /system/logo.png(与 openapi_saveCategory 一致)
传本系统 OSS 完整 URL 时会去掉域名前缀存相对路径;外链 URL 原样入库,不下载转存
品牌与限定机床
brand 新增、编辑均可写入;编辑时不传保持原品牌,传空字符串可清空
编辑时不传 ispartiallathe 和 partialLathes,保持原限定设置
ispartiallathe=0 会清除当前机构的限定机床关系,此时 partialLathes 必须为空或不传
ispartiallathe=1 时 partialLathes 必须为非空正整数数组;接口去重并校验机床启用状态和机构可操作范围,然后完整替换当前机构的关系
商品与限定机床关系在同一事务内更新;成功响应返回实际保存后的商品对象
删除方式:本接口 status=-1 删除,或调用独立接口 openapi_delProduct(错误提示文案略有不同);删除同时清理当前机构的限定机床关系。
前置条件:cid 必须是有效分类 ID。

请求参数

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_saveProduct?cid=172&pname=%E6%B5%8B%E8%AF%95%E5%95%86%E5%93%81%E5%90%8D%E7%A7%B0&pid=606&picture=%2Fupload%2Fproduct.png&mes_pid=A1&pcode=aaa&brand=%E5%93%81%E7%89%8C&status=1&ispartiallathe=undefined&partialLathes=undefined' \
--header 'token: 49895b412b4a87517f97ba31f1934a8f'

返回响应

🟢200
application/json
code=200 成功;code=500 业务错误
Bodyapplication/json

示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "id": 817,
        "name": "测试商品名称",
        "category_id": 172
    }
}
修改于 2026-08-04 05:28:42
上一页
新增/编辑/删除分类
下一页
删除商品
Built with