查询产品列表

分页查询当前企业的 LTC 商品和 SKU，可用于发现创建订单所需的 goods_id、sku_id、商品名称、规格、价格和库存。

创建订单时仍会按实时权威数据重新校验商品名称、规格、价格、上下架和库存，不能仅依赖本列表的历史响应。

错误码

错误码	含义
10001	access_token 未设置、错误或过期
10045	limit 超过最大值 50
10046	offset 非法或超出范围
10047	limit 不是正整数
10048	时间参数不是 10 位秒级或 13 位毫秒级时间戳
10049	参数格式、组合、枚举或请求体校验失败
22401	企业未开通对应的 LTC OpenAPI 能力
22403	订单、商品、回款等资源不存在或不属于当前企业
22414	LTC 服务暂不可用
22415	LTC 内部处理异常或响应不符合契约
22416	LTC 服务契约版本不受支持

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

HTTP 状态通常为 200，请以 errcode 判断业务结果。errcode=0 表示成功。

Bodyapplication/json

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "total_count": 1,
        "has_more": false,
        "limit": 20,
        "offset": 0,
        "goods": [
            {
                "goods_id": "100097608",
                "product_number": "2840429168780384055",
                "name": "示例商品",
                "product_type": "virtual",
                "product_type_name": "虚拟",
                "image_url": "https://example.com/goods.png",
                "description": "示例商品说明",
                "is_on_sale": true,
                "min_price": "1.00",
                "stock": 0,
                "is_stock_unlimited": true,
                "category": {
                    "id": "100093716",
                    "ext_id": null,
                    "name": "示例分类",
                    "display_state": "active"
                },
                "sku_list": [
                    {
                        "sku_id": "100096943",
                        "price": "1.00",
                        "spec_number": "100093716",
                        "spec_name": "ltc_default_spec",
                        "spec_param": {
                            "default": "ltc_default_spec"
                        },
                        "stock": 0,
                        "is_stock_unlimited": false
                    }
                ]
            }
        ]
    }
}

错误码#

请求参数

请求示例代码

返回响应

错误码