以下是API调用淘宝和京东商品详情接口的JSON格式数据示例:
淘宝商品详情接口JSON数据示例
淘宝商品详情接口(通常称为item_get或类似的名称)是淘宝开放平台提供的一个API接口,允许开发者根据商品的ID(Item ID)获取淘宝商品的详细信息。其JSON数据格式大致如下:
{ |
|
"request_id": "your_unique_request_id", // 请求的唯一标识符 |
|
"code": 0, // 返回码,0通常表示成功 |
|
"msg": "success", // 返回信息,成功时通常为"success" |
|
"item": { // 商品详情对象 |
|
"id": "123456789", // 商品ID |
|
"title": "商品标题示例", // 商品标题 |
|
"price": "199.00", // 商品价格,单位通常为元 |
|
"nick": "卖家昵称", // 卖家昵称 |
|
"shop_id": "987654321", // 店铺ID |
|
"shop_name": "店铺名称", // 店铺名称 |
|
"desc": "这里是商品的详细描述...", // 商品描述 |
|
"detail_url": "https://item.taobao.com/item.htm?id=123456789", // 商品详情页URL |
|
"skus": [ // SKU列表,如果商品有多个SKU |
|
{ |
|
"id": "sku_id_1", |
|
"price": "199.00", |
|
"stock": "100", |
|
"properties": "颜色:红色;尺码:L" // SKU属性 |
|
// ... 其他SKU相关字段 |
|
}, |
|
// ... 其他SKU |
|
], |
|
"images": [ // 商品图片列表 |
|
"http://img.example.com/product1.jpg", |
|
"http://img.example.com/product2.jpg", |
|
// ... 其他图片 |
|
], |
|
"properties": [ // 商品属性列表 |
|
{ |
|
"name": "品牌", |
|
"value": "XX品牌" |
|
}, |
|
{ |
|
"name": "材质", |
|
"value": "棉" |
|
}, |
|
// ... 其他属性 |
|
], |
|
"coupon_info": { // 优惠券信息(如果有) |
|
"amount": "10.00", // 优惠券金额 |
|
// ... 其他优惠券相关字段 |
|
}, |
|
"promotions": [ // 促销活动列表(如果有) |
|
{ |
|
"type": "满减", |
|
"desc": "满200减20" |
|
}, |
|
// ... 其他促销活动 |
|
], |
|
// ... 其他商品详情字段 |
|
} |
|
// 可能还有其他字段,如分页信息、总数量等,具体取决于API |
|
} |
京东商品详情接口JSON数据示例
京东商品详情接口允许开发者获取京东商城商品的详细信息,如图片、库存、规格、销量等。其JSON数据格式大致如下:
{ |
|
"item": { |
|
"num_iid": "商品唯一标识符", // 如 "123456789" |
|
"title": "商品标题", // 如 "某品牌某型号手机" |
|
"desc_short": "商品简短描述", // 可能为空 |
|
"price": "当前价格", // 如 "999.00" |
|
"original_price": "原价", // 如 "1299.00",若当前无促销则为原价 |
|
"nick": "店铺名称", // 如 "某品牌官方旗舰店" |
|
"num": "库存数量", // 如 "100",注意并非所有商品都会提供 |
|
"detail_url": "商品详情页链接", // 如 "https://item.jd.com/123456789.html" |
|
"pic_url": "商品主图URL", // 如 "http://example.com/main.jpg" |
|
"brand": "品牌名称", // 如 "某品牌" |
|
"brandId": "品牌ID", // 如 "1234" |
|
"item_imgs": [ // 商品详情图列表 |
|
{ |
|
"url": "http://example.com/detail1.jpg" |
|
}, |
|
{ |
|
"url": "http://example.com/detail2.jpg" |
|
} |
|
// ... 更多图片 |
|
], |
|
"props_name": "商品属性名称列表", // 如 "颜色:黑色;尺寸:160x75x8mm" |
|
"specification": [ // 商品规格参数列表 |
|
{ |
|
"key": "尺寸", |
|
"value": "160x75x8mm" |
|
}, |
|
{ |
|
"key": "重量", |
|
"value": "198g" |
|
}, |
|
{ |
|
"key": "颜色", |
|
"value": "黑色" |
|
} |
|
// ... 更多规格 |
|
], |
|
"after_service": { // 售后服务信息 |
|
"return_policy": "退换货政策", // 如 "7天无理由退换货" |
|
"warranty": "保修期", // 如 "1年" |
|
}, |
|
"evaluation": { // 评价信息(可能需单独调用评价API) |
|
"total_reviews": "评价总数", // 如 "1000" |
|
"positive_rate": "好评率", // 如 "95%" |
|
// ... 其他评价相关字段 |
|
}, |
|
// ... 其他商品详情字段 |
|
} |
|
// 可能还有其他字段,具体取决于API |
|
} |
注意事项:
- 上述JSON格式中的字段并不是固定的,它取决于请求的API接口以及请求时指定的参数。有些字段可能不存在于所有请求的返回结果中。
- 淘系平台和京东平台的API接口可能会不定期更新,包括返回的数据结构和字段。因此,建议定期查阅各开放平台提供的API文档,以获取最新的信息。
- 调用各电商平台的商品详情API接口需要注册成为相应开放平台的开发者,并获取相应的API密钥和权限。
- 在传输和存储过程中应确保用户隐私和敏感信息的安全。
- 在代码中添加异常处理逻辑,以应对可能的网络错误、API限制等问题。
通过上述示例,开发者可以高效地获取和展示商品信息,进而提升用户体验和销售效率。