SKU信息接口

提供获取多个SKU详细信息的能力，支持批量查询。

适用场景

获取SKU详细信息

接口类型

POST

请求频率限制

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

请求说明

请求URL

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

请求参数

Header参数

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

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
skus	array	是	-	-	商品SKU列表，支持批量查询，最多可传入100个SKU

响应字段说明

成功响应（HTTP 200）

根字段

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

data对象字段

字段	类型	说明
product_id	integer	产品ID
sku	string	商品SKU
model	string	规格型号
images	string	主图URL

调用示例

URL请求

请求示例

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

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "cbsft114yy02-一盒12pcs": {
            "product_id": 100,
            "sku": "cbsft114yy02-一盒12pcs",
            "model": "12pcs",
            "images": "https://oss.westmonth.com/westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg",
            "product_name": "South Moon 艾蒿臂贴 手臂和腿部天然草药艾灸贴"
        },
        "EEA02-A142-4-YE1": {
            "product_id": 90,
            "sku": "EEA02-A142-4-YE1",
            "model": "4g",
            "images": "https://oss.westmonth.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818017.jpg",
            "product_name": "EELHOE 维生素C眼霜棒 黑眼圈修护滋润紧致眼霜棒"
        },
        "EEA02-A143-20-VT1": {
            "product_id": 89,
            "sku": "EEA02-A143-20-VT1",
            "model": "20ml",
            "images": "https://oss.westmonth.com/westmonth/SKUDatum/EEA02-A143-20-VT1/mainpicture/EEA02-A143-20-VT1-1728289827018.jpg",
            "product_name": "EELHOE 烟酰胺精华 护肤提拉淡斑抗皱精华"
        },
        "EEA02-A144-30-WH1": {
            "product_id": 88,
            "sku": "EEA02-A144-30-WH1",
            "model": "30ml",
            "images": "https://oss.westmonth.com/westmonth/SKUDatum/old/EEA02-A144-30-WH1/mainpicture/EEA02-A144-30-WH1-002.jpg",
            "product_name": "EELHOE 抗皱面部精华 淡斑补水抗皱防衰老精华"
        }
    }
}

失败返回示例

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

错误处理

公共错误码

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

常见问题

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

A：一次最多可查询100个SKU的信息。

Q2：如果请求的SKU不存在，会返回什么？

A：如果请求的SKU不存在，该SKU不会在返回结果中出现。返回结果中只会包含存在的SKU信息。

版本历史

版本	日期	修改说明
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": {
        "cbsft114yy02-一盒12pcs": {
            "product_id": 100,
            "sku": "cbsft114yy02-一盒12pcs",
            "model": "12pcs",
            "images": "https://westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg"
        },
        "EEA02-A142-4-YE1": {
            "product_id": 90,
            "sku": "EEA02-A142-4-YE1",
            "model": "4g",
            "images": "https://westmonth/SKUDatum/old/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-001.jpg"
        },
        "EEA02-A143-20-VT1": {
            "product_id": 89,
            "sku": "EEA02-A143-20-VT1",
            "model": "20ml",
            "images": "https://westmonth/SKUDatum/old/EEA02-A143-20-VT1/mainpicture/EEA02-A143-20-VT1-001.jpg"
        },
        "EEA02-A144-30-WH1": {
            "product_id": 88,
            "sku": "EEA02-A144-30-WH1",
            "model": "30ml",
            "images": "https://westmonth/SKUDatum/old/EEA02-A144-30-WH1/mainpicture/EEA02-A144-30-WH1-001.jpg"
        }
    }
}

SKU信息

SKU信息接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

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

Q2：如果请求的SKU不存在，会返回什么？#

版本历史#

请求参数

请求示例代码

返回响应

SKU信息接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

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

Q2：如果请求的SKU不存在，会返回什么？

版本历史