SKU信息及价格接口

提供获取多个SKU详细信息及对应价格的能力，支持批量查询，且可根据指定国家和起订量获取相关信息。

适用场景

获取SKU详细信息及价格

接口类型

POST

请求频率限制

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

请求说明

请求URL

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

请求参数

Header参数

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

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
skus	array	是	-	-	SKU数组，最多200个
country_code	string	是	-	标准国家二字码，网上可查	国家二字码
minimum_quantity	integer	否	1	-	起定量，默认1

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时为空）
data	object	业务数据，包含多个SKU的信息及价格

data数组字段

字段	类型	说明
id	integer	ID
product_id	integer	产品ID
variants	array	SKU规格
position	integer	排序
images	string	图片URL
model	string	模型
sku	string	SKU
delivery_region_id	integer	发货区域ID
weight	integer	重量
weight_class	string	重量单位
combine	integer	是否组合装：0否，1是
onsale_at	string	上架时间，来自聚水潭的创建时间
created_at	string	创建时间
updated_at	string	更新时间
price	string	价格

调用示例

URL请求

请求示例

{
    "skus": [
        "EEA02-A144-30-WH1",
        "EEA02-A142-4-YE1",
        "EEA02-A143-20-VT1",
        "cbsft114yy02-一盒12pcs"
    ],
    "country_code": "US",
    "minimum_quantity": 1
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "id": 489,
            "product_id": 90,
            "variants": [],
            "position": 0,
            "images": "https://oss.westmonth.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818017.jpg",
            "model": "4g",
            "sku": "EEA02-A142-4-YE1",
            "delivery_region_id": 3,
            "weight": 19,
            "weight_class": "g",
            "combine": 0,
            "onsale_at": "2023-10-16 11:53:16",
            "created_at": "2023-10-18 02:42:22",
            "updated_at": "2025-06-02 21:12:11",
            "price": "29.53"
        },
        {
            "id": 499,
            "product_id": 89,
            "variants": [],
            "position": 0,
            "images": "https://oss.westmonth.com/westmonth/SKUDatum/EEA02-A143-20-VT1/mainpicture/EEA02-A143-20-VT1-1728289827018.jpg",
            "model": "20ml",
            "sku": "EEA02-A143-20-VT1",
            "delivery_region_id": 3,
            "weight": 88,
            "weight_class": "g",
            "combine": 0,
            "onsale_at": "2023-10-16 11:59:50",
            "created_at": "2023-10-19 01:30:49",
            "updated_at": "2025-06-02 21:12:11",
            "price": "29.53"
        },
        {
            "id": 513,
            "product_id": 100,
            "variants": [],
            "position": 0,
            "images": "https://oss.westmonth.com/westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg",
            "model": "12pcs",
            "sku": "cbsft114yy02-一盒12pcs",
            "delivery_region_id": 3,
            "weight": 49,
            "weight_class": "g",
            "combine": 0,
            "onsale_at": "2021-11-04 15:55:42",
            "created_at": "2023-10-19 08:05:08",
            "updated_at": "2025-06-02 21:12:17",
            "price": "29.53"
        }
    ]
}

失败返回示例

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

错误处理

公共错误码

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

常见问题

Q1：一次最多可以查询多少个SKU的信息及价格？

A：一次最多可查询200个SKU的信息及价格。

Q2：国家二字码有哪些规范？

A：国家二字码需遵循国际标准，可在网上查询获取正确的国家二字码，如美国为“US”，中国为“CN”等。

版本历史

版本	日期	修改说明
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": [
        {
            "id": 489,
            "product_id": 90,
            "variants": [],
            "position": 0,
            "images": "https://westmonth/SKUDatum/old/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-001.jpg",
            "model": "4g",
            "sku": "EEA02-A142-4-YE1",
            "delivery_region_id": 3,
            "weight": 19,
            "weight_class": "g",
            "combine": 0,
            "onsale_at": "2023-10-16 11:53:16",
            "created_at": "2023-10-18 02:42:22",
            "updated_at": "2024-11-26 16:33:08",
            "price": "29.05"
        },
        {
            "id": 499,
            "product_id": 89,
            "variants": "",
            "position": 0,
            "images": "https://westmonth/SKUDatum/old/EEA02-A143-20-VT1/mainpicture/EEA02-A143-20-VT1-001.jpg",
            "model": "20ml",
            "sku": "EEA02-A143-20-VT1",
            "delivery_region_id": 3,
            "weight": 88,
            "weight_class": "g",
            "combine": 0,
            "onsale_at": "2023-10-16 11:59:50",
            "created_at": "2023-10-19 01:30:49",
            "updated_at": "2024-07-08 16:07:01",
            "price": "29.05"
        },
        {
            "id": 513,
            "product_id": 100,
            "variants": [],
            "position": 0,
            "images": "https://westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg",
            "model": "12pcs",
            "sku": "cbsft114yy02-一盒12pcs",
            "delivery_region_id": 3,
            "weight": 49,
            "weight_class": "g",
            "combine": 0,
            "onsale_at": "2021-11-04 15:55:42",
            "created_at": "2023-10-19 08:05:08",
            "updated_at": "2024-08-23 14:23:40",
            "price": "29.05"
        }
    ]
}

SKU信息及价格

SKU信息及价格接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：一次最多可以查询多少个SKU的信息及价格？#

Q2：国家二字码有哪些规范？#

版本历史#

请求参数

请求示例代码

返回响应

SKU信息及价格接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：一次最多可以查询多少个SKU的信息及价格？

Q2：国家二字码有哪些规范？

版本历史