SKU列表接口

提供获取SKU列表的能力，支持分页查询SKU信息。

适用场景

获取SKU列表

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/product_skus/query
测试环境：https://testing.westmonth.com/openapi/product_skus/query

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
cursor	string	否	-	-	用于分页查询的游标，由上一次调用返回，首次调用可不填
limit	integer	否	50	1-100	返回的最大记录数，最大值100，默认值50，超过最大值时取最大值

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时为空）
data	object	业务数据

data对象字段

字段	类型	说明
total	integer	总记录数
next_cursor	string	分页游标，用于下次请求获取更多数据，若没有更多数据则为空
list	array	SKU列表

调用示例

URL请求

请求示例

{
    "limit": 10
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "total": 31467,
        "next_cursor": "eyJpdiI6InFRRGJmTDZKck92RkpzR1UxZkFkZ3c9PSIsInZhbHVlIjoiRENldTRTdFZMK3YvU1ZLV1FWT1hydz09IiwibWFjIjoiMDA3NGIxM2QyZTU2ZmZhMjZjOTYwMGYyNzg3ZjA2MTBjOTBhM2RiYWE3ZTAxY2QwMjQyMjIzYWQ3MTFmNjk1MSIsInRhZyI6IiJ9",
        "list": [
            "EEA02-A144-30-WH1",
            "EEA02-A142-4-YE1",
            "EEA02-A143-20-VT1",
            "cbsft114yy02-一盒12pcs",
            "WEA03-A051-30-WH1",
            "WEA02-A039-10-WH1",
            "OUA03-A067-100-PK1",
            "bns214yx01-40ml",
            "aijy114yx01-10ml",
            "sthl002-65g"
        ]
    }
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

常见问题

Q1：如何获取更多页的SKU列表？

A：首次调用时可不填cursor参数，获取第一页数据；之后每次调用时，将上一次返回的next_cursor作为cursor参数传入，直到next_cursor为空，即表示已获取全部数据。

Q2：limit参数的最大值是多少？

A：limit参数的最大值为100，若传入的值超过100，将自动取最大值100。

版本历史

版本	日期	修改说明
v1.0	2025-01-01	初始版本

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "total": 22856,
        "next_cursor": "eyJpdiI6IllqbXZrdGkyVFcxcldVQjJsUndQOFE9PSIsInZhbHVlIjoiQ0wwYzRhM3VnUXRRNmJmVy9rK3BWUT09IiwibWFjIjoiMTEyZWExNmVjZWRhMzFiYjdmOTMxZDg5YWNhM2Q1M2IzZTZiODI1NWRhYThkM2M4OTljYTkzZTc2ZmE0YjlkNSIsInRhZyI6IiJ9",
        "list": [
            "EEA02-A144-30-WH1",
            "EEA02-A142-4-YE1",
            "EEA02-A143-20-VT1",
            "cbsft114yy02-一盒12pcs",
            "WEA03-A051-30-WH1",
            "WEA02-A039-10-WH1",
            "OUA03-A067-100-PK1",
            "bns214yx01-40ml",
            "aijy114yx01-10ml",
            "sthl002-65g"
        ]
    }
}

SKU列表

SKU列表接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：如何获取更多页的SKU列表？#

Q2：limit参数的最大值是多少？#

版本历史#

请求参数

请求示例代码

返回响应

SKU列表接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：如何获取更多页的SKU列表？

Q2：limit参数的最大值是多少？

版本历史