SKU获取商品图包接口

提供查询多个SKU对应的商品图包（包含产品图、SKU图片、详情图等）的能力，支持根据指定时间范围筛选结果。

适用场景

获取SKU的各类图片资源，如产品主图、SKU专属图片、详情描述图片等

接口类型

POST

请求频率限制

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

请求说明

请求URL

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

请求参数

Header参数

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

Body参数

参数名	类型	必填	格式示例	说明
skus	array	是	`["ROA10-A006-10-BU1", "ROA10-A006-10-PK1"]`	商品SKU列表，最多200个
start_time	string	否	`2024-12-17 18:24:47`	更新开始时间，格式为YYYY-MM-DD HH:MM:SS
end_time	string	否	`2026-12-17 18:24:47`	更新结束时间，格式同上

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0=成功，1=服务错误，2=参数错误，3=授权无效，4=请求上限）
msg	string	错误描述（成功时为空）
data	array	业务数据数组，每个元素对应一个SKU的图包信息

data数组字段

字段	类型	说明
sku	string	商品SKU
images	object	图片分类容器，包含不同类型的图片列表
latest_time	string	图片列表的最新更新时间

images数组字段

字段	类型	说明
product	array	产品图列表，通常为商品的主视觉图片
sku	array	SKU图片列表，针对该具体SKU的专属图片
description	array	详情图列表，用于商品详情页描述的图片（可能为空）

调用示例

URL请求

请求示例

{
    "skus": [
        "ROA10-A006-10-BU1",
        "ROA10-A006-10-PK1"
    ],
    "start_time": "2024-12-17 18:24:47",
    "end_time": ""
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "sku": "ROA10-A006-10-BU1",
            "images": {
                "product": [
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-001.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-002.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-003.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-004.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-005.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-006.jpg"
                ],
                "sku": [
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-001.jpg"
                ],
                "description": [
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/product_content/ROA10-A006-10-BU1-001.gif",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/product_content/ROA10-A006-10-BU1-002.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/product_content/ROA10-A006-10-BU1-003.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/product_content/ROA10-A006-10-BU1-005.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/product_content/ROA10-A006-10-BU1-006.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/product_content/ROA10-A006-10-BU1-007.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/product_content/ROA10-A006-10-BU1-008.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/product_content/ROA10-A006-10-BU1-009.jpg"
                ]
            },
            "latest_time": "2025-06-30 14:18:12"
        },
        {
            "sku": "ROA10-A006-10-PK1",
            "images": {
                "product": [
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-001.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-002.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-003.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-004.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-006.jpg"
                ],
                "sku": [
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-001.jpg"
                ],
                "description": [
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/product_content/ROA10-A006-10-PK1-001.gif",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/product_content/ROA10-A006-10-PK1-002.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/product_content/ROA10-A006-10-PK1-003.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/product_content/ROA10-A006-10-PK1-005.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/product_content/ROA10-A006-10-PK1-006.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/product_content/ROA10-A006-10-PK1-007.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/product_content/ROA10-A006-10-PK1-008.jpg",
                    "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/product_content/ROA10-A006-10-PK1-009.jpg"
                ]
            },
            "latest_time": "2025-07-07 16:19:45"
        }
    ]
}

失败返回示例

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

错误处理

公共错误码

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

常见问题

Q1：description列表为空是什么原因？

A：部分SKU可能未配置专门的详情图，此时description列表为空，可直接使用product或sku列表中的图片作为补充。

Q2：product图和sku图有什么区别？

A：- product图：通常为同一产品系列的通用主图，适用于展示产品整体外观；

sku图：针对该具体SKU的图片，可能包含颜色、规格等差异化信息。

Q3：图片链接的有效期是多久？

A：图片链接为永久有效，但如果图片资源更新，旧链接可能指向新内容，建议通过latest_time字段判断是否需要重新获取。

版本历史

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

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "sku": "ROA10-A006-10-BU1",
            "images": {
                "product": [
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-001.jpg",
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-002.jpg",
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-003.jpg",
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-004.jpg",
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-005.jpg",
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-006.jpg"
                ],
                "sku": [
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-BU1/mainpicture/ROA10-A006-10-BU1-001.jpg"
                ],
                "description": []
            },
            "latest_time": "2025-03-03 10:29:04"
        },
        {
            "sku": "ROA10-A006-10-PK1",
            "images": {
                "product": [
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-001.jpg",
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-002.jpg",
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-003.jpg",
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-004.jpg",
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-005.jpg",
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-006.jpg"
                ],
                "sku": [
                    "https://westmonth/SKUDatum/old/ROA10-A006-10-PK1/mainpicture/ROA10-A006-10-PK1-001.jpg"
                ],
                "description": []
            },
            "latest_time": "2025-03-03 10:27:57"
        }
    ]
}

SKU商品图包

SKU获取商品图包接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：description列表为空是什么原因？

Q2：product图和sku图有什么区别？

Q3：图片链接的有效期是多久？

版本历史

请求参数

请求示例代码

返回响应

SKU商品图包

SKU获取商品图包接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：description列表为空是什么原因？#

Q2：product图和sku图有什么区别？#

Q3：图片链接的有效期是多久？#

版本历史#

请求参数

请求示例代码

返回响应

SKU获取商品图包接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：description列表为空是什么原因？

Q2：product图和sku图有什么区别？

Q3：图片链接的有效期是多久？

版本历史