一、接口概述
京东商品列表 API 接口是京东开放平台为开发者提供的重要工具，旨在方便开发者获取京东平台上丰富的商品信息。通过该接口，能够根据不同的查询条件，如关键词搜索、店铺 ID 指定、商品分类筛选等，精准地获取对应的商品列表数据。这些数据包含了商品的基础信息，如名称、价格、图片链接、库存数量等，以及商品的详细描述、评价数量和星级等拓展信息。接口的数据实时性较高，能让开发者及时掌握京东平台商品的动态变化，无论是用于电商数据分析、比价应用开发，还是构建商品展示平台，都具有极高的实用价值。小编：Taobaoapi2014
二、接口特点
数据丰富：返回的商品列表信息全面，不仅包含商品的基本属性，还涵盖了与商品销售相关的各类数据，如销量、评价详情等，为开发者提供了全方位了解商品的可能。
查询灵活：支持多种查询方式，开发者可依据业务需求，通过关键词搜索特定商品，或按店铺 ID 获取该店铺下的所有商品，亦能根据商品所属分类筛选商品列表，极大地满足了不同场景下的数据获取需求。
实时更新：京东平台商品信息变化频繁，该接口能够实时同步商品数据的更新，确保开发者获取到的始终是最新、最准确的商品信息，有助于提升应用的时效性和用户体验。
安全可靠：京东开放平台采用了严格的身份验证机制，通过 AppKey 和 AppSecret 进行签名认证，保证了接口调用的安全性，防止非法访问和数据泄露。同时，接口具备高可用性和稳定性，能够应对大量的并发请求，为开发者提供可靠的数据服务。
三、Python 请求示例
1. 安装必要的库
在使用 Python 调用京东商品列表 API 接口前，需安装requests库用于发送 HTTP 请求。
首先，需要获取京东开放平台分配的 AppKey 和 AppSecret。以下示例假设已获取到这两个关键信息，并以搜索关键词 “手机” 为例进行接口调用：
python
import requests
import hashlib
import time
import random
import string def generate_sign(params, app_secret): keys = sorted(params.keys())
query_string = '' for key in keys: query_string += key + str(params[key])
query_string += app_secret sign = hashlib.md5(query_string.encode('utf - 8')).hexdigest().upper() return sign
# 封装好的第三方数据商平台接口，复制链接获取测试。
demo url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014
app_key = 'your_app_key' app_secret = 'your_app_secret'
# 接口地址 url = 'api.jd.com/routerjson'
# 请求参数 params = { 'app_key': app_key, 'method': 'jd.union.open.goods.search', 'timestamp': time.strftime('%Y-%m-%d %H:%M:%S', time.localtime()), 'format': 'json', 'v': '2.0', 'sign_method': 'md5', 'keyword': '手机', 'page_size': 20, 'page_index': 1, 'channel': 1 }
# 生成签名 sign = generate_sign(params, app_secret) params['sign'] = sign
3. 发送请求并处理响应
构造好请求参数和签名后，发送 HTTP 请求并处理返回的 JSON 数据：
response = requests.post(url, data=params)if response.status_code==200:result = response.json()if result.get('code') =='0':goods_list = result.get('result').get('wareList')
for good in goods_list:print(good.get('title'), good.get('price')) else:print('请求失败，错误信息：', result.get('msg'))else:print('请求失败，状态码：', response.status_code)
上述代码中，首先定义了生成签名的函数generate_sign，该函数根据京东开放平台的签名规则，将请求参数和 AppSecret 拼接后进行 MD5 加密生成签名。然后设置了接口地址、请求参数，生成签名后将其添加到请求参数中。最后发送 POST 请求，若请求成功且返回的状态码为 200，进一步判断返回结果中的业务状态码，若为 0 表示请求成功，可获取并处理商品列表数据；否则打印错误信息。若请求失败，打印出请求的状态码。
