在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" // 示例，实际可能不包含 }, // 其他字段...
}
