1. 商品
西之月开放接口(openapi)
  • 西之月开放平台介绍
  • 西之月接入流程
  • 西之月开放API
  • 西之月订阅通知
  • 公共错误码
  • 货盘页面接入说明
  • openapi
    • 商品
      • 📖商品能力
      • SKU
        • SKU列表
        • SKU信息
        • SKU信息及价格
        • SKU查询客户价格
        • SKU查询英代欧代美代协议
        • SKU一体化标签
        • SKU一体化标签平台
        • SKU证书
        • SKU六面图
        • SKU商品图包
        • SKU视频
        • SKU商品标签【国内】
        • SKU产品文案
        • SKU实拍图附带一体化标签
        • SKU图包资料
      • 库存
        • 商品总库存列表
        • 商品分仓库存列表
        • 指定商品分仓库存
        • 圈货、备货库存查询
        • SKU实时库存【国内】
      • 商品列表
        GET
      • 商品详情
        GET
      • 商品价格
        POST
      • 个性化商品价格列表
        POST
      • 商品所有档位价格
        POST
      • 商品分类
        GET
      • 商品分类-获取子分类
        GET
      • 商品品牌
        GET
      • 商品证书
        GET
      • 商品使用说明书
        GET
    • 订单
      • 📖订单能力
      • 交接单
        • 交接单列表
        • 验证订单允许上传交接单
        • 上传交接单文件
        • 保存交接单
      • 创建订单
      • 订单预计算
      • 订单列表
      • 订单详情
      • 订单详情列表
      • 订单取消
      • 订单状态
      • 订单支付状态
      • 订单物流轨迹
    • 支付
      • 📖支付能力
      • 订单支付页面
      • 发起支付
      • 获取支付方式
      • 获取订单支付信息
    • 售后
      • 📖售后能力
      • 获取发起售后配置数据
      • 订单发起售后
      • 撤销售后
    • 账期
      • 📖账期能力
      • 已结清账期-账单列表
      • 未结清账期-账单列表
      • 未结清账单-销售订单列表
      • 未结清账单-售后订单列表
    • 品牌授权
      • 📖品牌授权能力
      • 获取授权平台列表
      • 获取模板类型列表
      • 获取授权品牌列表
      • 获取执照列表信息
      • 品牌授权申请
      • 品牌授权记录
      • 品牌授权作废
    • 其他
      • 📖其它能力
      • 仓库
        • 仓库列表信息
        • 发货区域列表
      • 物流
        • 物流公司列表
        • 获取运费接口
      • 平台
        • 获取授权码
        • 平台列表信息-新
        • 平台列表信息
      • 用户
        • 根据token获取用户信息
    • 订阅通知
      • 商品信息变更
      • 商品上下架状态变更
      • 商品库存变更
      • 商品价格变更
      • 商品删除
  1. 商品

商品详情

外部-测试环境
https://testing.westmonth.com
外部-测试环境
https://testing.westmonth.com
GET
/openapi/product/detail

商品详情接口#

用于获取指定商品的详细信息,包括商品基本信息、属性、图片、视频、价格、库存及配送区域等内容。

适用场景#

获取商品详情信息

接口类型#

GET

请求频率限制#

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

请求说明#

请求URL
正式环境:https://www.westmonth.com/openapi/product/detail
测试环境:https://testing.westmonth.com/openapi/product/detail

请求参数#

Header参数#

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

Query参数#

参数名类型必填默认值可选值说明
product_idinteger是-商品ID
localestring否zh_cn、enzh_cn:中文,en:英文。默认 zh_cn

响应字段说明#

成功响应(HTTP 200)
根 字段
字段类型说明
codeinteger业务状态码(0表示成功)
msgstring提示信息(成功时为空)
dataobject业务数据
data对象 字段
字段类型说明
idinteger产品ID
namestring产品名称
descriptionstring产品描述
meta_titlestringmeta 标题
meta_keywordsstringmeta 描述
meta_descriptionstringmeta 关键词
brand_idinteger品牌ID
brand_namestring品牌名称
platform_idinteger平台ID
platform_namestring平台名称
videostring视频链接
imagesarray图片数组
attributesarray属性数组
variablesobject多规格数据列表
skusarraySKU数组
in_wishlistinteger客户收藏数据ID
activebooleantrue:上架,false:下架
is_newinteger是否一个月内上架,0:否,1:是
is_seckillinteger是否秒杀商品,0:否,1:是
is_hot_saleinteger是否热销,0:否,1:是
product_categoriesarray产品分类数组
images数组 字段
字段类型说明
thumbstring缩略图 URL
previewstring预览图 URL
popupstring弹出图 URL
max_previewstring最大预览图 URL
attributes数组 字段
字段类型说明
attribute_group_nameinteger属性组名称
attributesinteger属性组列表
SKU数组 字段
字段类型说明
idinteger属性组名称
variantsarray规格值
positioninteger排序
imagesarray图片数组
modelstring模型
skustringSKU 编码
weightinteger重量
weight_classstring重量单位
pricestringSKU 价格
price_formatstring货币格式的价格
origin_pricestring原价划线价
origin_price_formatstring货币格式的划线价
is_defaultstring是否默认SKU(0:否;1:是)
delivery_region_idstring默认发货区域 ID
region_namestring默认发货区域名称
delivery_regionsobject配送区域
combineinteger是否组合装:0否,1是
hs_codestring海关编码
pattern_typeobjectgabalnara:包邮,afhalen:自提
regionsobjectSKU 发货区域信息
product_categories数组 字段
字段类型说明
category_idinteger产品分类ID
category_namestring产品分类名称
parent_idstring产品分类上级ID
levelstring层级
attributes数组 字段
字段类型说明
attributestring属性名
attribute_valuestring属性名
attribute_idstring属性名 ID
attribute_value_idstring属性值 ID
images数组 字段
字段类型说明
previewstring预览图 URL
popupstring弹出图 URL
thumbstring缩略图 URL
delivery_regions对象 字段
字段类型说明
idinteger配送区域 ID
delivery_region_idinteger发货区域 ID
delivery_region_codestring发货区域编码
delivery_region_namestring发货区域名称
wms_co_idinteger聚水潭仓库 ID
service_typestring服务 1:包邮,2:自提
pricestring价格
price_formatstring带符号的价格
origin_pricestring原价L
is_defaultinteger是否默认 SKU(0:否;1:是)
price_arrayarray多档价格数组
ring_stocksarray圈货参数
in_stockstring库存状态,0:缺货,1:有货
qtystring库存数量
in_stock_updated_atstring上架时间
regionPatternarray配送方式(afhalen:自提;gabalnara:快递配送)
guide_price_formatstring带符号的指导价格
afhalenobject美国发货区域价格数组(不包含运费)
gabalnaraobject美国发货区域价格数组(预估运费)
price_array数组 字段
字段类型说明
pricenumber价格
price_formatstring带符号的价格
minimum_quantityinteger起定量
multiple_pricenumber范围价格
paritienumber汇率
minimum_quantity_rangestring起定量区间
guide_pricestring带符号的指导价格
multiple_total_price_freight_usdstring多档位包邮总价(美区限定)
multiple_total_freight_usdstring多档位快递总价(美区限定)
afhalen对象 字段
字段类型说明
amount_format_CNYstring人民币价格
amount_format_USDstring美元价格
product_totalstring商品价格(美元)
freight_totalstring运费价格(美元)
gabalnara对象 字段
字段类型说明
amount_format_CNYstring人民币价格(含运费)
amount_format_USDstring美元价格(含运费)
product_totalstring商品价格(美元)
freight_totalstring运费价格(美元)

调用示例#

URL请求#

请求示例#

成功返回示例#

{
    "code": 0,
    "msg": "",
    "data": {
        "id": 31728,
        "name": "Hoegoa 灰色发际线粉 自然填充修容粉遮高修鬓角阴影笔防水持久不掉色",
        "description": "<p>我们的灰色发际线粉,由改性玉米淀粉、淀粉辛烯基琥珀酸铝精心调配而成。专为均匀上色并自然修饰发际线设计。使用方法极为便捷:使用前轻轻摇晃瓶子,沿着凌乱头发的根部轻拍,以填补头发中的空隙。并且它可以瞬间覆盖白发,隐形稀疏的发根,清爽不油腻。</p>\n",
        "meta_title": "",
        "meta_keywords": "",
        "meta_description": "",
        "brand_id": 40,
        "brand_name": "Hoegoa",
        "brand_main_name": "广州赫戈雅生物科技有限公司",
        "brand_logo": "https://oss.westmonth.com/westmonth/upload/Help/Brand logo/20250408172753800072.svg",
        "platform_id": 0,
        "platform_name": "",
        "video": "",
        "images": [
            {
                "thumb": "https://resource.westmonth.com/6647647d2e785f/18ba933eb39945b5bfb28a040e101aba_image[1752829731388][250718170851].png",
                "preview": "https://resource.westmonth.com/6647647d2e785f/18ba933eb39945b5bfb28a040e101aba_image[1752829731388][250718170851].png",
                "popup": "https://resource.westmonth.com/6647647d2e785f/18ba933eb39945b5bfb28a040e101aba_image[1752829731388][250718170851].png",
                "max_preview": "https://resource.westmonth.com/6647647d2e785f/18ba933eb39945b5bfb28a040e101aba_image[1752829731388][250718170851].png"
            }
        ],
        "attributes": [
            {
                "attribute_group_name": "默认",
                "attributes": [
                    {
                        "attribute": "净含量",
                        "attribute_value": "2g",
                        "attribute_id": 9,
                        "attribute_value_id": 8645
                    }
                ]
            }
        ],
        "variables": [],
        "skus": [
            {
                "id": 37678,
                "variants": [
                    0
                ],
                "position": 0,
                "images": [
                    {
                        "preview": "https://resource.westmonth.com/6647647d2e785f/18ba933eb39945b5bfb28a040e101aba_image[1752829731388][250718170851].png",
                        "popup": "https://resource.westmonth.com/6647647d2e785f/18ba933eb39945b5bfb28a040e101aba_image[1752829731388][250718170851].png",
                        "thumb": "https://resource.westmonth.com/6647647d2e785f/18ba933eb39945b5bfb28a040e101aba_image[1752829731388][250718170851].png"
                    }
                ],
                "model": "2g",
                "sku": "HG-A03-0670-02",
                "weight": 25,
                "weight_class": "g",
                "price": 10,
                "price_format": "¥10.00",
                "origin_price": 10,
                "origin_price_format": "¥10.00",
                "quantity": 0,
                "is_default": 1,
                "delivery_region_id": 5,
                "region_id": 116938,
                "region_name": "中国",
                "delivery_regions": {
                    "116938": {
                        "id": 116938,
                        "product_sku_id": 37678,
                        "delivery_region_id": 5,
                        "delivery_region_code": "CN",
                        "delivery_region_name": "中国",
                        "wms_co_id": 0,
                        "service_type": "",
                        "price": "10.00",
                        "price_format": "¥10.00",
                        "origin_price": "0.00",
                        "origin_price_format": "¥0.00",
                        "is_default": 1,
                        "price_array": [
                            {
                                "priceGear": 0,
                                "price": "10.00",
                                "product_price": 10,
                                "price_format": "¥10.00",
                                "guide_price": "¥20",
                                "real_price": ""
                            },
                            {
                                "priceGear": 1,
                                "price": "0.00",
                                "product_price": 0,
                                "price_format": "¥0.00",
                                "guide_price": "¥0",
                                "real_price": ""
                            },
                            {
                                "priceGear": 2,
                                "price": "0.00",
                                "product_price": 0,
                                "price_format": "¥0.00",
                                "guide_price": "¥0",
                                "real_price": ""
                            }
                        ],
                        "ring_stocks": [],
                        "in_stock": 1,
                        "qty": 99999,
                        "in_stock_updated_at": "2025-07-18 17:42:49",
                        "regionPattern": [
                            "gabalnara",
                            "afhalen"
                        ],
                        "guide_price_format": "CNY ¥20",
                        "real_price": ""
                    }
                },
                "combine": 0,
                "hs_code": null,
                "pattern_type": {
                    "116938": [
                        "gabalnara",
                        "afhalen"
                    ]
                },
                "regions": {
                    "116938": "中国"
                }
            }
        ],
        "in_wishlist": 0,
        "active": true,
        "is_new": 1,
        "is_seckill": 0,
        "is_hot_sale": 0,
        "month_sale": "100+",
        "parities": 0,
        "product_categories": [
            {
                "category_id": 100122,
                "category_name": "头部护理与造型",
                "position": 98,
                "parent_id": 0,
                "level": 1
            }
        ]
    }
}

失败返回示例#

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

错误处理#

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

常见问题#

版本历史#

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

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://testing.westmonth.com/openapi/product/detail?product_id=90&locale=zh_cn' \
--header 'Authorization: {{token}}' \
--header 'Cookie: {{cookie}};{{cookie}}' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "msg": "",
    "data": {
        "id": 90,
        "name": "EELHOE 维生素C眼霜棒 黑眼圈修护滋润紧致眼霜棒",
        "description": "<p>我们的维生素C眼霜棒含有甘油硬脂酸酯、卡波姆、抗坏血酸(维生素C),它可以滋养和保护眼部,滋润和提亮眼部肌肤,减少黑眼圈。它的使用方法很简单:洁面爽肤后,将眼霜棒底部打开,轻轻涂抹在眼周肌肤上,用指尖从内到外按摩吸收。提供更稳定的保养,使皮肤更明亮紧致,减少眼圈和浮肿。<img class=\"img-fluid\" style=\"display: block; margin-left: auto; margin-right: auto;\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818001.gif\"><img class=\"img-fluid\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818018.jpg\"><img class=\"img-fluid\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818003.jpg\"><img class=\"img-fluid\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1734080433015.png\"><img class=\"img-fluid\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818014.jpg\"><img class=\"img-fluid\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818008.jpg\"><img class=\"img-fluid\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818015.jpg\"><img class=\"img-fluid\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818009.jpg\"><img class=\"img-fluid\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818013.jpg\"><img class=\"img-fluid\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818012.jpg\"><img class=\"img-fluid\" src=\"https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818011.jpg\"></p>\n",
        "meta_title": "",
        "meta_keywords": "",
        "meta_description": "",
        "brand_id": 0,
        "brand_name": "",
        "brand_main_name": "",
        "brand_logo": "",
        "platform_id": 0,
        "platform_name": "",
        "video": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818000.mp4",
        "images": [
            {
                "thumb": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/20250527192604616832.jpg",
                "preview": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/20250527192604616832.jpg",
                "popup": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/20250527192604616832.jpg",
                "max_preview": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/20250527192604616832.jpg"
            }
        ],
        "attributes": [
            {
                "attribute_group_name": "默认",
                "attributes": [
                    {
                        "attribute": "净含量",
                        "attribute_value": "4g",
                        "attribute_id": 9,
                        "attribute_value_id": 316
                    },
                    {
                        "attribute": "产品名称",
                        "attribute_value": "维生素C眼霜棒",
                        "attribute_id": 12,
                        "attribute_value_id": 318
                    }
                ]
            }
        ],
        "variables": [],
        "skus": [
            {
                "id": 489,
                "variants": [
                    0
                ],
                "position": 0,
                "images": [
                    {
                        "preview": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818017.jpg",
                        "popup": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818017.jpg",
                        "thumb": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/westmonth/SKUDatum/EEA02-A142-4-YE1/mainpicture/EEA02-A142-4-YE1-1728361818017.jpg"
                    }
                ],
                "model": "4g",
                "sku": "EEA02-A142-4-YE1",
                "weight": 19,
                "weight_class": "g",
                "price": 98.11,
                "price_format": "¥98.11",
                "origin_price": 98.11,
                "origin_price_format": "¥98.11",
                "quantity": 0,
                "is_default": 1,
                "delivery_region_id": 14,
                "region_id": 72478,
                "region_name": "欧盟",
                "delivery_regions": {
                    "47915": {
                        "id": 47915,
                        "product_sku_id": 489,
                        "delivery_region_id": 3,
                        "delivery_region_code": "US",
                        "delivery_region_name": "美国",
                        "wms_co_id": 13625047,
                        "service_type": "1,2",
                        "price": "28.72",
                        "price_format": "¥28.72",
                        "origin_price": "28.89",
                        "origin_price_format": "¥28.89",
                        "is_default": 0,
                        "price_array": [
                            {
                                "priceGear": 0,
                                "price": 28.72,
                                "product_price": 28.72,
                                "price_format": "USD $4.00",
                                "minimum_quantity": 1,
                                "multiple_price": 28.72,
                                "paritie": 0.072211,
                                "minimum_quantity_range": 1,
                                "guide_price": "$7.99",
                                "multiple_total_price_freight_usd": "$16.10",
                                "multiple_total_freight_usd": "$12.11",
                                "real_price": ""
                            },
                            {
                                "priceGear": 1,
                                "price": 21.57,
                                "product_price": 21.57,
                                "price_format": "USD $3.00",
                                "minimum_quantity": 2,
                                "multiple_price": 21.57,
                                "paritie": 0.072211,
                                "minimum_quantity_range": "2-2",
                                "guide_price": "$6.00",
                                "multiple_total_price_freight_usd": "$19.09",
                                "multiple_total_freight_usd": "$13.09",
                                "real_price": ""
                            },
                            {
                                "priceGear": 2,
                                "price": 19.2,
                                "product_price": 19.2,
                                "price_format": "USD $2.68",
                                "minimum_quantity": 3,
                                "multiple_price": 19.2,
                                "paritie": 0.072211,
                                "minimum_quantity_range": "3-3",
                                "guide_price": "$5.35",
                                "multiple_total_price_freight_usd": "$22.12",
                                "multiple_total_freight_usd": "$14.11",
                                "real_price": ""
                            },
                            {
                                "priceGear": 3,
                                "price": 17.98,
                                "product_price": 17.98,
                                "price_format": "USD $2.51",
                                "minimum_quantity": 4,
                                "multiple_price": 17.98,
                                "paritie": 0.072211,
                                "minimum_quantity_range": ">=4",
                                "guide_price": "$5.01",
                                "multiple_total_price_freight_usd": "$24.07",
                                "multiple_total_freight_usd": "$14.07",
                                "real_price": ""
                            }
                        ],
                        "ring_stocks": [],
                        "in_stock": 1,
                        "qty": "24169",
                        "in_stock_updated_at": "2023-10-16 11:53:16",
                        "regionPattern": [
                            "afhalen",
                            "gabalnara"
                        ],
                        "guide_price_format": "USD $7.99",
                        "afhalen": {
                            "amount_format_CNY": "CNY ¥28.72",
                            "amount_format_USD": "USD $4.00",
                            "product_total": "USD $4.00",
                            "freight_total": "USD $0"
                        },
                        "gabalnara": {
                            "amount_format_CNY": "CNY ¥115.76",
                            "amount_format_USD": "USD $16.10",
                            "product_total": "USD $4.00",
                            "freight_total": "USD $12.11"
                        },
                        "real_price": "$0.00"
                    }
                },
                "combine": 0,
                "hs_code": "3304200092",
                "pattern_type": {
                    "47915": [
                        "afhalen",
                        "gabalnara"
                    ],
                    "47916": [
                        "gabalnara",
                        "afhalen"
                    ],
                    "47917": [
                        "gabalnara",
                        "afhalen"
                    ],
                    "65878": [
                        "gabalnara"
                    ],
                    "68135": [
                        "gabalnara"
                    ],
                    "69674": [
                        "gabalnara"
                    ],
                    "72478": [
                        "gabalnara",
                        "afhalen"
                    ],
                    "73134": [
                        "gabalnara"
                    ]
                },
                "regions": {
                    "47915": "美国",
                    "47916": "泰国",
                    "47917": "中国",
                    "65878": "澳洲",
                    "68135": "新西兰",
                    "69674": "俄罗斯",
                    "72478": "欧盟",
                    "73134": "英国"
                }
            }
        ],
        "in_wishlist": 0,
        "active": true,
        "is_new": 0,
        "is_seckill": 0,
        "is_hot_sale": 0,
        "month_sale": "100+",
        "parities": 0,
        "product_categories": [
            {
                "category_id": 100233,
                "category_name": "眼部护理",
                "position": 0,
                "parent_id": 100225,
                "level": 3
            },
            {
                "category_id": 100121,
                "category_name": "美容护理",
                "position": 99,
                "parent_id": 0,
                "level": 1
            },
            {
                "category_id": 100225,
                "category_name": "面部美容护理",
                "position": 0,
                "parent_id": 100121,
                "level": 2
            }
        ]
    }
}
修改于 2026-02-24 03:17:40
上一页
商品列表
下一页
商品价格
Built with