京东商品列表API接口 主要用于获取商品的基础信息和详细信息,包括商品标题、价格、库存、图片等。
接口功能与权限
获取商品SKU的完整信息:包括标题、价格、库存、促销活动、主图、详情页描述等。支持批量查询及多维度字段筛选,返回数据包含京东自营与第三方店铺商品。
接口参数说明
method:固定值为jingdong.ware.product.detail.search.get
sku_ids:商品SKU列表,多个ID用英文逗号分隔(如12345,67890)
fields:指定返回字段(默认全量),如wareId,title,price,imagePath
app_key:应用身份标识,从开放平台控制台获取
timestamp:请求时间戳(格式yyyy-MM-dd HH:mm),服务端校验时效性
调用示例
以下是一个使用Python调用京东商品列表API的示例代码:
import requests
import hashlib
import time
from urllib.parse import quote
# 配置参数
app_key = "YOUR_APP_KEY"
sku_ids = "12345,67890" # 示例SKU
access_token = "YOUR_ACCESS_TOKEN" # OAuth2.0令牌
timestamp = str(int(time.time())) # 当前时间戳
# 生成签名
def jd_sign(params):
sorted_params = sorted(params.items())
sign_base = '&'.join([f'{k}{v}' for k, v in sorted_params]) + app_secret
sign = hashlib.md5(sign_base.encode()).hexdigest()
return sign
# 构建请求URL和参数
params = {
'method': 'jd.item.get',
'itemId': sku_ids, # 示例商品ID列表
'app_key': app_key,
'timestamp': timestamp,
'format': 'json',
'v': '1.0',
'sign_method': 'md5',
}
params['sign'] = jd_sign(params) # 生成签名
url = f'https://api.jd.com/routerjson' # 示例API地址,实际使用时需替换为正确的API地址
headers = {
'Authorization': f'Bearer {access_token}', # OAuth2.0令牌认证
}
response = requests.get(url, params=params, headers=headers)
print(response.json()) # 打印返回的JSON数据