一、接口概述
京东商品列表 API 接口是京东开放平台为开发者提供的重要工具，旨在方便开发者获取京东平台上丰富的商品信息。通过该接口，能够根据不同的查询条件，如关键词搜索、店铺 ID 指定、商品分类筛选等，精准地获取对应的商品列表数据。这些数据包含了商品的基础信息，如名称、价格、图片链接、库存数量等，以及商品的详细描述、评价数量和星级等拓展信息。接口的数据实时性较高，能让开发者及时掌握京东平台商品的动态变化，无论是用于电商数据分析、比价应用开发，还是构建商品展示平台，都具有极高的实用价值。小编：Taobaoapi2014
二、接口特点
数据丰富：返回的商品列表信息全面，不仅包含商品的基本属性，还涵盖了与商品销售相关的各类数据，如销量、评价详情等，为开发者提供了全方位了解商品的可能。
查询灵活：支持多种查询方式，开发者可依据业务需求，通过关键词搜索特定商品，或按店铺 ID 获取该店铺下的所有商品，亦能根据商品所属分类筛选商品列表，极大地满足了不同场景下的数据获取需求。
实时更新：京东平台商品信息变化频繁，该接口能够实时同步商品数据的更新，确保开发者获取到的始终是最新、最准确的商品信息，有助于提升应用的时效性和用户体验。
安全可靠：京东开放平台采用了严格的身份验证机制，通过 AppKey 和 AppSecret 进行签名认证，保证了接口调用的安全性，防止非法访问和数据泄露。同时，接口具备高可用性和稳定性，能够应对大量的并发请求，为开发者提供可靠的数据服务。
三、Python 请求示例
安装必要的库
在使用 Python 调用京东商品列表 API 接口前，需安装requests库用于发送 HTTP 请求。若尚未安装，可通过以下命令在命令行中安装：
代码解读复制代码pip install requests构造请求参数及签名
首先，需要获取京东开放平台分配的 AppKey 和 AppSecret。以下示例假设已获取到这两个关键信息，并以搜索关键词 “手机” 为例进行接口调用：
```js
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发送请求并处理响应
构造好请求参数和签名后，发送 HTTP 请求并处理返回的 JSON 数据：
scss 代码解读复制代码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 表示请求成功，可获取并处理商品列表数据；否则打印错误信息。若请求失败，打印出请求的状态码。
