1. 商品管理
Gokoo Third-Party Integration API
  • En
    • Start Readme Channel API Guide
    • Authentication
      • Channel Partner Authorization Login
      • Get Channel Partner AccessToken
      • Get Merchant OpenID
    • Product Management - Categories
      • Create Category
      • Edit Category
      • Delete Category
      • Get Category Detail
      • List Categories (Management)
      • List All Categories (For Product List)
      • Sort Categories
    • Merchant Management
      • Set delivery time
      • Business hours-set by day
      • Business hours setting
      • Modify business status
      • Set appointment days
      • Business hours management
    • Product Management - Products
      • Create Product
      • Edit Product
      • Delete Product
      • Get Product Detail
      • List Products
      • Search Products
      • Upload Product Image
      • Set Product On/Off Shelf (Batch)
      • Batch Update Product Stock
      • Batch Sold Out (Clear Stock)
      • Sort Products
    • Delivery Orders
      • Accept Order
      • Cancel Order (Merchant Reject)
      • Mark Food Ready (Prepared)
      • Apply for Delivery / Merchant Start Self-Delivery
      • Merchant Self-Delivery Completed
      • Query Order by Pickup Code
      • Verify Pickup Order (Scan Code)
      • List Orders (By Status)
      • Get Order Detail
      • Get Order Financial Details
      • Reprint Receipt
      • Order financial details-for Thailand
      • Order financial details-for Malaysia
    • Webhooks
      • Order Status Change Callback
  • 中文
    • 接口说明 v1.0
    • 商品管理
      • 商品排序
        POST
      • 全部分类（商品列表用）
        POST
      • 添加分类
        POST
      • 分类管理列表
        POST
      • 删除分类
        POST
      • 商品图片上传
        POST
      • 商品上下架(含批量)
        POST
      • 分类详情
        POST
      • 添加商品
        POST
      • 商品列表(搜索)
        POST
      • 商品批量改库存
        POST
      • 删除商品
        POST
      • 商品详情
        POST
      • 修改商品
        POST
      • 商品批量沽清
        POST
      • 分类排序
        POST
      • 商品列表
        POST
      • 修改分类
        POST
    • 商户管理
      • 营业时间——按天设置
      • 设置配送时间
      • 营业时间设置
      • 修改营业状态
      • 营业时间管理
      • 设置预约天数
    • 账户部分
      • 渠道商授权获取AccessToken
      • 渠道商授权获取商户openid
      • 渠道商授权登录
    • 外卖订单
      • 重新打印小票
      • 订单状态变更回调
      • 扫码核销订单
      • 取消订单（商家拒单）
      • 自提码查询订单
      • 订单账目
      • 订单列表(各种状态的)
      • 订单详情
      • 订单财务明细-泰国
      • 订单财务明细-马来西亚
      • 沙箱-创建订单
      • 接单
      • 出餐
      • 申请配送_商家自己开始配送
      • 商家自配送完成
      • 沙箱-发送订单状态变更回调
  • Schemas
    • CommonBodyParams
    • CommonResponse
    • SuccessResponse
    • ErrorResponse
    • TimeSlot
    • TimeSlotWithSeconds
    • CategoryItem
    • ProductItem
    • NormSpec
    • NormGroup
    • OrderProduct
    • ShowButtons
    • StaffInfo
  1. 商品管理

添加商品

POST
/api.php
添加商品
请求参数明细
参数名必选类型说明
data.title是string商品名称
data.unit是string商品单位
data.cate_id是string分类，可多个，用逗号分隔
data.price是string商品价格
data.tags否string标签
data.spec.spec_name否string规格名称
data.spec.price否string规格加个
data.spec.package_price否string规格包装费
data.spec.sale_sku否int规格库存
data.spec.max_sku否int规格最大库存
data.spec.start_selling否int规格起售数量
data.spec.weight否int规格重量
data.specification.key否string属性键值
data.specification.val否array属性值
data.package_price是string打包费
data.sale_sku是string库存
data.max_sku是string最大库存
data.is_reset是string次日是否置满库存 0 否 1 是
data.reset_time是string每日置满时间(和is_reset关联)
data.is_must是string是否为必点商品 0 否 1 是
data.is_hot是string是否为热门商品 0 否 1 是
data.is_tuijian是string是否为推荐商品 0 否 1 是
data.photo是string商品图片，上传先请求上传接口
data.intro是string商品介绍
data.norms否array规格组
data.norms.norms_name是string规格组名称
data.norms.max_spec_num是int最多可选规格数量，和添加的规格数量相同
data.norms.specs是array具体规格组中规格信息
data.norms.specs.nspec_name是string规格名称
data.norms.specs.price是float规格价格
data.norms.specs.package_price否float规格包装费，默认0
data.norms.specs.group_num否int计价份数,默认1
data.norms.specs.min_count是int最小份数
data.norms.specs.max_count是int最大份数
data.norms.specs.sale_sku否int当前库存,默认99999
data.norms.specs.max_sku是int最大库存,默认99999

Request

Query Params

Header Params

Body Params application/x-www-form-urlencodedRequired

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api.php?API=biz%2Fproduct%2Fproduct%2Fcreate' \
--header 'Authorization: {{bearerToken}}' \
--data-urlencode 'data={"cate_id":"85264","intro":"贼拉拉好吃的油焖大虾","is_hot":"0","is_must":"0","is_reset":"1","is_tuijian":"1","max_sku":"50","norms":[{"max_spec_num":"2","norms_name":"套餐","specs":[{"group_num":2,"max_count":4,"max_sku":10,"min_count":2,"norms_id":0,"nspec_name":"情人节套餐","num":0,"package_price":0.0,"price":800.0,"sale_sku":5},{"group_num":1,"max_count":5,"max_sku":30,"min_count":1,"norms_id":0,"nspec_name":"单人套餐","num":0,"package_price":0.0,"price":300.0,"sale_sku":28}]}],"package_price":"20","photo":"photo/202604/20260408_F079F4DCF765D398F61B3EEADBC932A8.jpeg","price":"580","reset_time":"6:00","sale_sku":"5","shop_sku":"3216543265","spec":[{"index":-1,"max_sku":"66","package_price":"20","price":"600","sale_sku":"6","shop_sku":"545421643798","spec_name":"大份","start_selling":"1","weight":"400"},{"index":-1,"max_sku":"10","package_price":"20","price":"500","sale_sku":"3","shop_sku":"8464662878","spec_name":"小份","start_selling":"1","weight":"300"}],"specification":[{"index":-1,"key":"口味","val":["微辣","蒜香","酱香"]}],"title":"油焖大虾","unit":"份","weight":"300"}' \
--data-urlencode 'CLIENT_API=BIZ' \
--data-urlencode 'openid={{openid}}'

Responses

🟢200
application/json
Success
Bodyapplication/json

Example
{
	"data": {
		"product_id": "1706989"
	},
	"error": "0",
	"message": "\u521b\u5efa\u6210\u529f"
}
Modified at 2026-06-18 08:53:22
Previous
分类详情
Next
商品列表(搜索)
Built with