在API返回值中,商品价格与优惠信息的具体位置可能因不同的电商平台和API设计而有所不同。然而,一般来说,这些信息会以结构化的方式呈现,通常包含在一个包含多个字段的JSON对象或XML文档中。以下是根据多个电商平台(如阿里巴巴1688、抖音、京东等)的API返回值结构,对商品价格与优惠信息位置的概括性描述:
商品价格
- 商品价格:通常会直接在API返回值中作为一个字段出现,如“price”或“price_amount”,并伴随货币单位信息(如“CNY”表示人民币)。这个字段表示商品的标准售价或当前售价。
- 促销价格:如果商品正在进行促销活动,API返回值中可能会包含“promotion_price”或类似名称的字段,用于表示促销后的价格。
- 原价与折扣信息:部分API返回值还可能包含商品的原价(如“original_price”)和折扣信息(如“discount_rate”或“discount_amount”),以便消费者了解商品的优惠力度。
taobao.item_get_app
- taobao.item_get_app-1.0.0-6.0.html
- taobao.item_get_app-1.0.0-7.0.html
- taobao.item_get_app-2.0.0-1.0.html
- taobao.item_get_app-2.0.0-2.0.html
- taobao.item_get_app-2.0.0-3.0.html
- taobao.item_get_app-2.0.0-7.0.html
- taobao.item_get_app-3.0.0-7.0.html
- taobao.item_get_app-4.0.0-7.0.html
- taobao.item_get_app-4.0.1-7.0.html
- taobao.item_get_app-4.0.2-7.0.html
- taobao.item_get_app-4.0.3-7.0.html
- taobao.item_get_app-4.0.4-7.0.html
公共参数
请求地址:
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数:num_iid=520813250866
参数说明:num_iid:淘宝商品ID
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
item | Mix | 0 | 获得淘宝app商品详情原数据 |
优惠信息
- 优惠活动详情:优惠信息可能以多种形式呈现,包括但不限于满减、打折、赠品等。这些信息可能会作为一个独立的字段(如“promotion_info”或“discount_details”)出现在API返回值中,包含具体的优惠条件和优惠额度。
- 优惠码或优惠券:虽然不直接属于API返回值的常规内容,但在某些电商平台的API设计中,可能会提供获取优惠码或优惠券的接口,这些优惠码或优惠券可以在用户购买商品时使用。
示例结构(以JSON为例)
{
"商品ID": "123456",
"商品标题": "某品牌手机",
"价格": {
"原价": 9999,
"促销价": 8999,
"货币单位": "CNY"
},
"优惠信息": {
"满减活动": "满1000减100",
"折扣率": "9折",
"优惠码": "XYZ123" // 示例,实际可能不包含
},
// 其他字段...
}