京东商品详情 API 接口的返回值实践运用

22 阅读3分钟

京东商品详情 API 接口的返回值通常是一个包含多个字段的 JSON 对象,以下是一些常见的返回值字段及其说明:

  1. 商品基本信息

    • num_iid:商品在京东平台上的唯一 ID,用于标识商品的身份。
    • title:商品的名称或标题,包含了商品的品牌、型号、主要功能等关键信息。
    • nick:商品的店铺名称或卖家昵称。
    • detail_url:商品的详情页面链接,用户可以通过该链接访问京东平台上的商品详细信息页面。
  2. 价格相关信息

    • price:商品的销售价格,通常以元为单位。
    • orginal_price:商品的原价,若有促销活动,该字段表示商品原来的价格。
    • suggestive_price:建议价格或参考价格,可能是京东平台根据市场情况或其他因素给出的参考价。
  3. 库存信息:有的接口可能会返回商品的库存数量等相关信息,有助于了解商品的库存状况,但不是所有的接口都一定包含此信息。

  4. 图片信息

    • pic_url:商品的图片链接或 URL,可以根据这些链接获取商品的图片信息。通常会返回主图的链接,有些接口可能还会返回商品的详情图等其他图片的链接。
  5. 商品描述信息

    • desc:商品的详细描述信息,包括商品的材质、尺寸、包装、使用方法、功能特点等详细内容。
  6. 其他信息

    • 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&param_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}")

请注意:

  1. 以上代码仅为示例,实际使用时需要替换your_app_keyyour_app_secret为你在京东开放平台申请的真实值。
  2. 商品详情 API 的具体参数和返回值可能会根据京东开放平台的更新而有所变化,使用前请仔细阅读官方文档。
  3. 此代码中的 URL 和参数设置可能不是最准确的,实际调用时需要按照京东开放平台的文档进行调整。