在拍立淘API的返回值中,商品价格与优惠信息通常位于与商品相关的详细信息对象中。由于拍立淘API是由不同的电商平台提供的(如淘宝/天猫、京东、1688等),它们的返回值结构和字段名称可能会有所不同,但一般遵循类似的逻辑。以下是根据多个来源综合整理的信息:
商品价格
- 位置:商品价格(如
price
字段)通常直接位于描述单个商品的JSON对象中。 - 内容:价格可能包含原价和促销价等信息,具体取决于API的实现和电商平台的政策。
- 示例:在淘宝/天猫的拍立淘API中,价格字段可能直接显示为
price
,而在京东的拍立淘API中则可能显示为price
或其他类似名称。
taobao.item_search_img
公共参数
请求地址:
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
请求参数
请求参数:imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg
参数说明:imgid:图片地址(支持淘宝或天猫图片地址,外部地址先调用上传图片(upload_img)接口,返回图片地址)
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
page:页数
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
title | String | 0 | 亲子装短袖t恤社会人衣服全家装一家三口母子母女纯棉夏装上衣潮 | 宝贝标题 |
cid | Int | 0 | 50015374 | |
list_type | String | 0 | 外观相似宝贝 | 列表类型 |
pic_url | String | 0 | //g-search3.alicdn.com/img/bao/uploaded/i4/TB26ry1rBsmBKNjSZFsXXaXSVXa_!!2628705716.jpg | 宝贝图片 |
promotion_price | String | 0 | 38.71 | 优惠价 |
price | Float | 0 | 39.50 | 价格 |
sales | Int | 0 | 7 | 销量 |
num_iid | Bigint | 0 | 575727312808 | 宝贝ID |
sample_id | Bigint | 0 | 1627115368 | 商品风格标识ID |
seller_nick | String | 0 | 专属味道之dzw | 掌柜昵称 |
is_tmall | Bool | 0 | false | |
post_fee | String | 0 | 0.00 | 物流费用 |
area | String | 0 | 广东 东莞 | 店铺所在地 |
detail_url | String | 0 | //item.taobao.com/item.htm?id=575727312808&ns=1#detail | 宝贝链接 |
优惠信息
- 位置:优惠信息(如优惠券、满减等)可能不是所有拍立淘API返回值的标准部分,但它可能会作为一个额外的字段或嵌套在商品信息中。
- 内容:如果提供优惠信息,它可能包含优惠券的金额、使用条件、有效期等详细信息。
- 示例:在某些情况下,优惠信息可能以
promotion
、discount
或类似名称的字段出现,但具体名称和格式取决于API的文档和电商平台的开放策略。
示例结构(以淘宝/天猫拍立淘API为例)
{
"request_id": "xxx", // 请求的唯一标识符
"code": 200, // 响应状态码,表示请求成功
"msg": "Success", // 与code对应的消息描述
"items": [ // 包含搜索结果的列表
{
"num_iid": "商品ID", // 商品ID
"title": "商品标题", // 商品标题
"pic_url": "商品图片URL", // 商品主图URL
"price": "199.00", // 商品价格
"detail_url": "商品详情页URL", // 商品详情页链接
"seller_id": "卖家ID", // 卖家ID
"nick": "卖家昵称", // 卖家昵称
"promotion": { // 优惠信息(如果存在)
"discount_amount": "10.00", // 优惠金额
"conditions": "满200减10" // 使用条件
}
// ...其他字段
},
// ...其他商品信息
]
}