一、接口概述
京东店铺所有商品 API 接口是京东开放平台为开发者提供的一项关键服务,旨在为其获取特定店铺内的全部商品信息提供便捷途径。借助这一接口,开发者只需提供店铺的唯一标识(通常为店铺 ID),就能精准定位并批量获取该店铺所售商品的丰富数。这些数据包含商品的基本属性,如商品名称、图片链接、价格、库存数量等;商品的详细描述,有助于用户深入了解商品特性;以及商品所属的分类、品牌信息等。无论是用于电商数据分析、店铺运营监测,还是构建商品聚合平台,此接口都能为开发者提供不可或缺的数据支持。小编:Taobaoapi2014
二、接口特点
- 全面覆盖:能够一次性获取指定店铺下的所有商品信息,无需对每个商品进行单独请求,大大提高了数据获取效率。这对于需要对店铺整体商品情况进行分析,如统计店铺商品种类数量、计算商品平均价格等场景非常实用。
- 店铺精准定位:通过店铺 ID 作为唯一索引,确保获取的数据准确无误地来源于目标店铺。开发者可以轻松针对不同店铺进行数据采集和分析,无论是大型旗舰店还是小型特色店铺,都能精准获取其商品数据。
- 实时数据更新:随着京东店铺内商品的动态变化,如新品上架、商品价格调整、库存变动等,该接口能够实时同步最新数据。开发者始终能获取到店铺商品的最新状态,为用户提供及时、准确的商品信息。据安全可靠的调用机制:京东开放平台采用严格的安全措施保障接口的安全使用。通过 AppKey 和 AppSecret 进行身份验证,并对请求进行签名处理,有效防止非法请求和数据泄露,确保接口调用的安全性和稳定性,为开发者提供可靠的数据服务。
三、Python 请求示例
1. 安装必要的库
在使用 Python 调用京东店铺所有商品 API 接口前,需安装requests库用于发送 HTTP 请求。若尚未安装,可通过以下命令在命令行中安装:
pip install requests
2. 构造请求参数及签名
假设已获取到京东开放平台分配的 AppKey 和 AppSecret,以获取店铺 ID 为 “123456” 的店铺所有商品数据为例:
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.shop.goods.get', # 假设获取店铺商品的接口方法名
'timestamp': time.strftime('%Y-%m-%d %H:%M:%S', time.localtime()),
'format': 'json',
'v': '2.0',
'sign_method':'md5',
'shopId': '123456', # 店铺ID
'page': 1, # 页码,当商品数量较多时可能需分页获取
'pageSize': 50 # 每页商品数量,可根据需求调整
}
生成签名
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':
product_list = result.get('result').get('goodsList')
for product in product_list:
print(product.get('title'), product.get('price'), product.get('stockNum'))
else:
print('请求失败,错误信息:', result.get('msg'))
else:
print('请求失败,状态码:', response.status_code)
上述代码中,先定义了生成签名的函数generate_sign,该函数遵循京东开放平台的签名规则,将请求参数与 AppSecret 拼接后进行 MD5 加密生成签名。接着设置了接口地址、请求参数,生成签名并添加到请求参数中。最后发送 POST 请求,若请求成功且返回状态码为 200,进一步判断返回结果中的业务状态码,若为 0 表示请求成功,可获取并处理商品列表数据;否则打印错误信息。若请求失败,打印出请求的状态码。当店铺商品数量较多时,可能需要通过循环调整page参数来分页获取所有商品数据。