1. Product Management - Products
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
        POST
      • Edit Product
        POST
      • Delete Product
        POST
      • Get Product Detail
        POST
      • List Products
        POST
      • Search Products
        POST
      • Upload Product Image
        POST
      • Set Product On/Off Shelf (Batch)
        POST
      • Batch Update Product Stock
        POST
      • Batch Sold Out (Clear Stock)
        POST
      • Sort Products
        POST
    • 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
    • 商品管理
      • 商品排序
      • 全部分类(商品列表用)
      • 添加分类
      • 分类管理列表
      • 删除分类
      • 商品图片上传
      • 商品上下架(含批量)
      • 分类详情
      • 添加商品
      • 商品列表(搜索)
      • 商品批量改库存
      • 删除商品
      • 商品详情
      • 修改商品
      • 商品批量沽清
      • 分类排序
      • 商品列表
      • 修改分类
    • 商户管理
      • 营业时间——按天设置
      • 设置配送时间
      • 营业时间设置
      • 修改营业状态
      • 营业时间管理
      • 设置预约天数
    • 账户部分
      • 渠道商授权获取AccessToken
      • 渠道商授权获取商户openid
      • 渠道商授权登录
    • 外卖订单
      • 重新打印小票
      • 订单状态变更回调
      • 扫码核销订单
      • 取消订单(商家拒单)
      • 自提码查询订单
      • 订单账目
      • 订单列表(各种状态的)
      • 订单详情
      • 订单财务明细-泰国
      • 订单财务明细-马来西亚
      • 沙箱-创建订单
      • 接单
      • 出餐
      • 申请配送_商家自己开始配送
      • 商家自配送完成
      • 沙箱-发送订单状态变更回调
  • Schemas
    • CommonBodyParams
    • CommonResponse
    • SuccessResponse
    • ErrorResponse
    • TimeSlot
    • TimeSlotWithSeconds
    • CategoryItem
    • ProductItem
    • NormSpec
    • NormGroup
    • OrderProduct
    • ShowButtons
    • StaffInfo
  1. Product Management - Products

List Products

POST
/api.php
product list
** Request parameter details: **
parameter namerequiredtypedescription
data.pagenointpaging
data.cate_idyesstringIt can be the real ID of the category, or it can be the three fixed categories of hot, must, and tuijian
data.statusnointProduct status 0 All 1 On sale 2 Removed 3 Sold out
** Return parameter description **
parameter nametypedescription
datajsondata content
data.itemsarrayproduct list
data.items.product_idintcommodity id
data.items.cate_idintLevel 1 Classification ID
data.items.cat_idintSecondary Classification ID
data.items.titlestringcommodity titles
data.items.photostringcommodity picture
data.items.pricestringcommodity prices
data.items.package_pricestringpacking fee
data.items.saleintsales
data.items.sale_skuintinventory
data.items.status_labelstringProduct status
data.total inttotal number
data.curr_pageintcurrent page
data.pagesintTotal number of pages

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
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%2Fnewproduct%2Fproducts' \
--header 'Authorization: Bearer <token>' \
--data-urlencode 'CLIENT_API=' \
--data-urlencode 'CLIENT_API=BIZ' \
--data-urlencode 'openid=' \
--data-urlencode 'openid={{openid}}' \
--data-urlencode 'data={"page":1,"cate_id":"hot","status":"0"}'

Responses

🟢200
application/json
Successful response
Bodyapplication/json

Example
{
    "data": {
        "items": [
            {
                "product_id": "string",
                "cate_id": "string",
                "cat_id": "string",
                "title": "string",
                "photo": "string",
                "price": "string",
                "package_price": "string",
                "sales": "string",
                "sale_sku": "string",
                "is_onsale": "string",
                "unit": "string",
                "is_hot": "string",
                "is_must": "string",
                "is_tuijian": "string",
                "status_label": "string"
            }
        ],
        "total_count": "string",
        "curr_page": "string",
        "pages": "string",
        "total": "string"
    },
    "error": "0",
    "message": "success"
}
Modified at 2026-06-18 10:39:08
Previous
Get Product Detail
Next
Search Products
Built with