API调用淘宝京东商品详情接口示例参考,json格式数据示例
以下是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限制等问题。
通过上述示例,开发者可以高效地获取和展示商品信息,进而提升用户体验和销售效率。