京东商品详情 API 返回的数据是一个结构化的 JSON 对象,包含了商品的多个关键字段。以下是一些常见的返回值字段及其说明:
1. 商品基本信息
-
num_iid:商品唯一标识符。
-
title:商品标题。
-
desc_short:商品简短描述。
-
brand:商品品牌。
-
category:商品分类。
-
origin:商品产地。
2. 价格信息
-
price:商品当前价格。
-
original_price:商品原价。
-
discount_price:商品促销价。
-
promotion_info:活动信息,如满减、折扣等。
3. 库存信息
-
stock_quantity:当前库存数量。
-
sales_volume:销量。
4. 评价信息
-
rating:用户评分。
-
comment_count:评论数量。
-
comments:评论内容列表(可能需要额外请求)。
5. 图片和媒体信息
-
pic_url:商品主图 URL。
-
images:商品图片列表。
-
videos:商品视频(如果有的话)。
6. 规格参数
-
skuList:商品的 SKU 列表,每个 SKU 代表一个具体的商品规格和价格组合。
-
skuId:SKU 的 ID。
-
name:SKU 的名称。
-
price:SKU 的价格。
-
stock:SKU 的库存数量。
-
-
props_list:商品属性列表,如尺码、颜色等。
7. 店铺信息
-
seller_info:卖家信息,包括卖家 ID、店铺 ID 等。
8. 其他信息
-
detail_url:商品详情页 URL。
-
description:商品详细描述。
示例 JSON 数据
JSON
{"code": "0","errorMessage": "success","jingdong_item_detail_response": {"items": [{"num_iid": "1234567890","title": "商品标题","desc_short": "商品简短描述","brand": "品牌名称","category": "分类名称","origin": "产地","price": "120.00","original_price": "150.00","discount_price": "100.00","promotion_info": "满减信息","stock_quantity": 100,"sales_volume": 500,"rating": 4.5,"comment_count": 200,"pic_url": "https://img10.360buyimg.com/n1/s200x200_jfs/t1/123456/1/1234567890.jpg","images": ["https://img10.360buyimg.com/n1/s200x200_jfs/t1/123456/1/1234567890.jpg","https://img10.360buyimg.com/n1/s200x200_jfs/t1/123456/2/1234567890.jpg"],"videos": ["https://video.jd.com/1234567890.mp4"],"skuList": [{"skuId": "123456","name": "红色","price": "120.00","stock": 50}],"props_list": {"color": "红色","size": "L"},"seller_info": {"seller_id": "123456","shop_id": "789012"},"detail_url": "https://item.jd.com/1234567890.html","description": "商品详细描述"}]}
}
注意事项
-
API 使用限制:京东 API 接口有调用频率限制,超出限制可能导致服务不可用。因此,在调用接口时需要注意控制请求频率。
-
数据安全:获取的商品详情数据应妥善保管,不得用于非法用途。
-
更新跟进:京东 API 接口可能会更新或变更,因此需要及时关注京东开放平台的更新通知,以便及时调整自己的代码和策略。
通过以上字段说明和示例数据,你可以更好地理解和使用京东商品详情 API 返回的数据。希望这些信息对你有所帮助!