京东商品详情 API 接口的返回值通常是一个包含多个字段的 JSON 对象,以下是一些常见的返回值字段及其说明:
-
商品基本信息:
num_iid
:商品在京东平台上的唯一 ID,用于标识商品的身份。title
:商品的名称或标题,包含了商品的品牌、型号、主要功能等关键信息。nick
:商品的店铺名称或卖家昵称。detail_url
:商品的详情页面链接,用户可以通过该链接访问京东平台上的商品详细信息页面。
-
价格相关信息:
price
:商品的销售价格,通常以元为单位。orginal_price
:商品的原价,若有促销活动,该字段表示商品原来的价格。suggestive_price
:建议价格或参考价格,可能是京东平台根据市场情况或其他因素给出的参考价。
-
库存信息:有的接口可能会返回商品的库存数量等相关信息,有助于了解商品的库存状况,但不是所有的接口都一定包含此信息。
-
图片信息:
pic_url
:商品的图片链接或 URL,可以根据这些链接获取商品的图片信息。通常会返回主图的链接,有些接口可能还会返回商品的详情图等其他图片的链接。
-
商品描述信息:
desc
:商品的详细描述信息,包括商品的材质、尺寸、包装、使用方法、功能特点等详细内容。
-
其他信息:
brand
:商品的品牌。brandid
:品牌的 ID。rootcatid
:商品的顶级分类 ID,可用于商品的分类管理和统计。cid
:商品的具体分类 ID,用于更详细的商品分类。created_time
:商品的创建时间。modified_time
:商品的修改时间。delist_time
:商品的下架时间(如果该商品已下架,会返回相应的时间信息)。
以下是使用 Python 的requests
库调用京东商品详情 API 的示例代码:
python
import requests
# 假设这是你的 AppKey 和 AppSecret
app_key = 'your_app_key'
app_secret = 'your_app_secret'
# 商品 ID
item_id = '12345678'
# 构建请求 URL
url = f'https://api.jd.com/routerjson?app_key={app_key}&method=jingdong.item.get&access_token=&v=2.0¶m_json={"sku":{item_id}}'
# 发送请求
response = requests.get(url)
# 解析响应数据
if response.status_code == 200:
data = response.json()
# 打印商品标题
print(f"商品标题:{data.get('result', {}).get('item', {}).get('title', '')}")
# 打印商品价格
price = data.get('result', {}).get('item', {}).get('price', '')
print(f"商品价格:{price}")
# 打印商品图片链接
pic_url = data.get('result', {}).get('item', {}).get('pic_url', '')
print(f"商品图片链接:{pic_url}")
else:
print(f"请求失败,状态码:{response.status_code}")
请注意:
- 以上代码仅为示例,实际使用时需要替换
your_app_key
和your_app_secret
为你在京东开放平台申请的真实值。 - 商品详情 API 的具体参数和返回值可能会根据京东开放平台的更新而有所变化,使用前请仔细阅读官方文档。
- 此代码中的 URL 和参数设置可能不是最准确的,实际调用时需要按照京东开放平台的文档进行调整。