商品价格接口

提供获取商品价格相关信息的能力，支持根据发货区、商品SKU等参数查询商品的单价、总价、币种等信息。

适用场景

查询商品价格信息

接口类型

POST

请求频率限制

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

请求说明

请求URL

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

请求参数

Header参数

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

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
delivery_region_id	integer	是	-	通过接口获取：/openapi/productCategory/getDeliveryRegions	发货区ID
product_sku_id	integer	是	-	-	商品SKU_ID（与商品SKU编号，二选一）
product_sku	string	是	-	-	商品SKU编号（与商品SKU_ID，二选一）
quantity	integer	否	1	-	商品数量
service_type	integer	否	2	1=包邮、2=自提	服务类型（圈货备货不需要）
stock_batch	string	否	-	-	圈货备货批次号
uID	string	否	-	-	客户UID（ERP必填）

响应字段说明

成功响应（HTTP 200）

根字段

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

data对象（成功时）字段

字段	类型	说明
price_currency	string	价格币种
currency_symbol	string	币种符号
price_discount	integer	折扣比例（0~1）
original_price	string	原价（区域币种）
original_price_cny	string	原价（人民币）
price	string	商品单价（区域币种）
price_cny	string	商品单价（人民币）
quantity	integer	商品数量
price_total	string	商品总价（区域币种）
price_total_cny	string	商品总价（人民币）
price_type	integer	价格类型（1=普通商品，2=圈货商品，3=备货商品）

调用示例

URL请求

请求示例

{
    "delivery_region_id": 3,
    "product_sku": "EE06221131-60ml"
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "price_currency": "USD",
        "currency_symbol": "$",
        "price_discount": 1,
        "original_price": "3.99",
        "original_price_cny": "29.52",
        "price": "3.99",
        "price_cny": "29.52",
        "quantity": 1,
        "price_total": "3.99",
        "price_total_cny": "29.52",
        "price_type": 1
    }
}

失败返回示例

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

错误处理

公共错误码

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

常见问题

Q1：product_sku_id和product_sku必须都传吗？

A：不需要，两者二选一即可，根据实际获取到的商品标识选择其中一个传入。

Q2：service_type参数在什么情况下不需要传？

A：当查询的是圈货备货商品的价格时，不需要传service_type参数。

版本历史

版本	日期	修改说明
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": {
        "price_currency": "THB",
        "currency_symbol": "฿",
        "price_discount": 1,
        "original_price": "100.00",
        "original_price_cny": "22",
        "price": "100.00",
        "price_cny": "22",
        "quantity": 2,
        "price_total": "200.00",
        "price_total_cny": "44.00",
        "price_type": 1
    }
}

商品价格

商品价格接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：product_sku_id和product_sku必须都传吗？#

Q2：service_type参数在什么情况下不需要传？#

版本历史#

请求参数

请求示例代码

返回响应

商品价格接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：product_sku_id和product_sku必须都传吗？

Q2：service_type参数在什么情况下不需要传？

版本历史