1. 基础档案
OpenApi
  • API 说明文档
  • 基础档案
    • 游戏列表
      GET
    • 平台列表
      GET
    • 产品列表
      GET
    • 批量设置产品阶梯销售价
      POST
    • 区服列表(树形)
      GET
    • 渠道列表
      GET
    • 批量设置产品毛利率
      POST
    • 产品分类列表(树形)
      GET
    • 添加产品
      POST
    • 添加产品库产品
      POST
    • 游戏档案全量拉取(增量同步)
      GET
    • 平台档案全量拉取(增量同步)
      GET
    • 区服档案全量拉取(增量同步)
      GET
    • 当前租户币种设置
      GET
    • 获取销售价格管理列表
      GET
  • 采购商
    • 原始订单
      • 创建原始订单
      • 修改原始订单
      • 修改原始订单交易信息
      • 取消原始订单
      • 暂停原始订单
      • 恢复原始订单
    • 请购单
      • 订单列表
      • 订单详情
      • 更新订单
      • 删除订单
      • 创建订单
      • 暂停订单
      • 恢复订单
      • 取消订单
      • 放弃剩余数量
      • 创建询价
      • 追加询价
      • 重新派单
    • 询价
      • 询价单列表
      • 询价单详情
      • 发布询价单
      • 取消询价单
      • 手动添加供应商
      • 移除供应商
    • 报价
      • 报价列表
      • 报价详情
    • 比价
      • 比价单列表
      • 比价单详情
      • 从询价单创建比价单
      • 选标(分配中标+生成PO)
      • 取消比价单
    • 采购订单
      • 采购订单列表
      • 采购订单详情
      • 暂停采购订单
      • 恢复采购订单
      • 取消采购订单
      • 处理问题单
      • 完结申请审核
      • 催单采购订单
    • 订单变更
      • 变更列表
      • 变更详情
      • 发起变更
    • 对账单
      • 对账单列表
      • 对账单详情
      • 采购商确认对账
      • 采购商发起争议
      • 解决争议
      • 作废对账单
      • 重新生成对账单
    • 付款
      • 付款列表
      • 付款详情
      • 发起付款申请
      • 审批通过
      • 审批驳回
      • 重新提交
      • 登记付款
  • 供应商
    • 询价
      • 询价单列表
      • 询价单详情
    • 报价
      • 报价列表
      • 报价详情
      • 提交报价
      • 作废报价
      • 报价结果列表(含报价明细)
      • 报价结果详情
    • 客户订单
      • 客户订单列表
      • 客户订单详情
      • 开始发货
      • 提交发货(支持分批发货)
      • 申请完结(部分发货订单)
      • 上报问题
    • 订单变更
      • 变更列表
      • 变更详情
      • 确认变更
      • 拒绝变更
    • 对账单
      • 对账单列表
      • 对账单详情
      • 供应商确认对账
      • 供应商发起争议
    • 收款
      • 收款列表
      • 收款详情
      • 关联对账单
  1. 基础档案

批量设置产品阶梯销售价

POST
/open-api/v1/archive/product-prices/cost
批量设置当前供应商租户的产品阶梯销售价,支持新增/修改/删除。定位优先级:条目带 id → 按档位 ID 精确匹配(id 须为正整数或纯数字字符串,非法值计入该条目 data.errors;须属于当前供应商,未提交的 min_quantity/max_quantity/price 沿用该记录原值,可只改价或只改区间);无 id → 按产品编码/ID + 区间匹配(同产品同区间已有档则更新,否则新增)。顶层 delete_ids 传入要删除的档位 ID 数组(元素须为正整数或纯数字字符串,非法时返回 422;仅删除属于当前供应商的记录,其余 ID 忽略)。区间规则:min/max 为非负整数,缺省或 0~0 视为不限数量默认档(每产品最多一条);具体档需 1 ≤ min_quantity ≤ max_quantity,同产品各档区间不得交叉。price 为空或 0 视为未设置价格(档位仍占区间);负数、区间非法、精度超限等单条校验错误一律计入 data.errors(code=200,不整批抛 422)。全量校验模式:任一条校验失败则整批不入库,一次性返回全部错误。items 单次最多 2000 条;items 与 delete_ids 不能同时为空(否则返回 422);同一档位 ID 不得同时出现在 items(更新)与 delete_ids(删除)中,也不得在同一次请求的 items 中重复更新,否则整批拒绝并计入 data.errors。

请求参数

Body 参数application/json必填

示例
{
    "items": [
        {
            "id": 0,
            "product_code": "string",
            "product_id": 0,
            "price": "string",
            "min_quantity": 0,
            "max_quantity": 0
        }
    ],
    "delete_ids": [
        0
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.gamescm.com/open-api/v1/archive/product-prices/cost' \
--header 'Content-Type: application/json' \
--data '{
    "items": [
        {
            "id": 0,
            "product_code": "string",
            "product_id": 0,
            "price": "string",
            "min_quantity": 0,
            "max_quantity": 0
        }
    ],
    "delete_ids": [
        0
    ]
}'

返回响应

🟢200
application/json
操作结果(校验失败时 success=0 并返回全部错误)
Bodyapplication/json

示例
{
    "code": 200,
    "message": "success",
    "data": {
        "total": 2,
        "success": 2,
        "errors": []
    }
}
修改于 2026-11-10 08:30:40
上一页
产品列表
下一页
区服列表(树形)
Built with