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
      • 商品单位列表
        POST
    • 商户管理
      • 营业时间——按天设置
      • 设置配送时间
      • 营业时间设置
      • 修改营业状态
      • 营业时间管理
      • 设置预约天数
    • 账户部分
      • 渠道商授权获取AccessToken
      • 渠道商授权获取商户openid
      • 渠道商授权登录
    • 外卖订单
      • 重新打印小票
      • 订单状态变更回调
      • 扫码核销订单
      • 取消订单（商家拒单）
      • 自提码查询订单
      • 订单账目
      • 订单列表(各种状态的)
      • 订单详情
      • 订单财务明细-泰国
      • 订单财务明细-马来西亚
      • 沙箱-创建订单
      • 接单
      • 出餐
      • 申请配送_商家自己开始配送
      • 商家自配送完成
      • 沙箱-发送订单状态变更回调
  • Schemas
    • CommonBodyParams
    • CommonResponse
    • SuccessResponse
    • ErrorResponse
    • TimeSlot
    • TimeSlotWithSeconds
    • CategoryItem
    • ProductItem
    • NormSpec
    • NormGroup
    • OrderProduct
    • ShowButtons
    • StaffInfo
  1. 商品管理

商品列表

POST
/api.php
商品列表
请求参数明细：
参数名必选类型说明
data.page否int分页
data.cate_id是string可以是分类的真实ID，也可以为hot，must，tuijian三个固定分类
data.status否int商品状态 0全部 1售卖中 2已下架 3已售罄
返回参数说明
参数名类型说明
datajson数据内容
data.itemsarray商品列表
data.items.product_idint商品ID
data.items.cate_idint一级分类ID
data.items.cat_idint二级分类ID
data.items.titlestring商品标题
data.items.photostring商品图片
data.items.pricestring商品价格
data.items.package_pricestring打包费
data.items.saleint销量
data.items.sale_skuint库存
data.items.status_labelstring商品状态
data.total_count 和 data.totalint总数量
data.curr_pageint当前页
data.pagesint总分页数

Request

Query Params

Header Params

Body Params application/x-www-form-urlencoded

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%2Fnewproduct%2Fproducts' \
--header 'Authorization: {{bearerToken}}' \
--data-urlencode 'data={"page":1,"cate_id":"hot","status":"0"}' \
--data-urlencode 'CLIENT_API=BIZ' \
--data-urlencode 'openid={{openid}}'

Responses

🟢200
Success
This response does not have a body.
Example
{
    "data": {
        "items": [
            {
                "product_id": "1510949",
                "cate_id": "76599",
                "cat_id": "0",
                "title": "新的虾3333",
                "photo": "https://img1.gokoo.com//photo/xxx.jpg",
                "price": "105.00",
                "package_price": "2.00",
                "sales": "8",
                "sale_type": "1",
                "sale_sku": "100",
                "sale_count": "8",
                "intro": "我是商品介绍",
                "orderby": "50",
                "dateline": "1769392481",
                "is_hot": "0",
                "is_onsale": "1",
                "unit": "个",
                "specification": [
                    {
                        "key": "color",
                        "val": [
                            "红",
                            "绿"
                        ]
                    },
                    {
                        "key": "taste",
                        "val": [
                            "微辣",
                            "辣"
                        ]
                    }
                ],
                "shop_sku": "",
                "cate_ids": [
                    "76599"
                ],
                "cat_ids": [
                    ""
                ],
                "is_must": "0",
                "is_tuijian": "1",
                "audit": "1",
                "is_discount": "0",
                "audit_cancel_btn": "0",
                "status_label": ""
            },
            {
                "product_id": "1510948",
                "cate_id": "76599",
                "cat_id": "0",
                "title": "新的虾",
                "photo": "https://img1.gokoo.com//photo/xxx.jpg",
                "price": "105.00",
                "package_price": "2.00",
                "sales": "0",
                "sale_type": "1",
                "sale_sku": "100",
                "sale_count": "0",
                "intro": "我是商品介绍",
                "orderby": "50",
                "dateline": "1769391638",
                "is_hot": "0",
                "is_onsale": "1",
                "unit": "个",
                "specification": [
                    {
                        "key": "color",
                        "val": [
                            "红",
                            "绿"
                        ]
                    },
                    {
                        "key": "taste",
                        "val": [
                            "微辣",
                            "辣"
                        ]
                    }
                ],
                "shop_sku": "",
                "cate_ids": [
                    "76599"
                ],
                "cat_ids": [
                    "0"
                ],
                "is_must": "0",
                "is_tuijian": "1",
                "audit": "1",
                "is_discount": "0",
                "audit_cancel_btn": "0",
                "status_label": ""
            }
        ],
        "total_count": "2",
        "curr_page": "1",
        "pages": "1",
        "total": "2"
    },
    "error": "0",
    "message": "success"
}
Modified at 2026-06-23 02:21:38
Previous
分类排序
Next
修改分类
Built with