一、引言
在电商业务蓬勃发展的当下，对于商家、开发者以及数据分析人员而言，获取电商平台上店铺的商品信息至关重要。京东作为国内知名的电商平台，拥有海量的商品资源。京东店铺所有商品 API 为开发者提供了一个强大的工具，能够批量获取指定京东店铺内的所有商品详细信息。借助该 API，商家可以对自家店铺商品进行管理和分析，开发者可以构建电商相关的应用程序，数据分析人员能够挖掘商品数据背后的商业价值。通过深入研究和合理运用这个 API，能够提高电商运营效率、优化用户体验，为电商业务的发展提供有力支持。
二、接口概述
- 接口功能
该 API 的主要功能是根据用户传入的京东店铺 ID，返回该店铺内所有商品的详细信息。这些信息涵盖了商品的基本属性，如商品名称、价格、库存数量、商品描述、图片链接等；还包括商品的销售相关信息，如销量、评价数量等。 - 请求方式
一般采用 HTTP 的 POST 方式。POST 方式适合传递复杂的参数，在获取大量商品信息时，可能需要传递多个参数来精确筛选和获取数据，使用 POST 方式能更好地满足这种需求。 - 响应数据格式
响应数据以 JSON 格式返回，示例如下：
json{
"code": 200,
"message": "success",
"data": {"total": 100, "page": 1, "page_size": 20, "products": [ { "product_id": "123456", "name": "商品名称", "price": 199.00, "stock": 50, "description": "商品详细描述", "image_url": "https://example.com/product_image.jpg", "sales": 1000, "evaluation_count": 200 }, // 其他商品信息 ]}
}
其中，code 表示请求的状态码，message 是状态信息，total 是该店铺商品的总数，page 是当前页码，page_size 是每页商品数量，products 是商品信息列表。
三、Python 请求示例
以下是使用 Python 的 requests 库调用京东店铺所有商品 API 的示例代码：
python
import requests
import hashlib
import time
import urllib.parse
# 假设 API 接口地址，复制链接获取测试。
API url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014"
def generate_sign(params, app_secret):
"""
生成签名
:param params: 请求参数
:param app_secret: 应用密钥
:return: 签名
"""
sorted_params = sorted(params.items(), key=lambda x: x[0])
sign_str = app_secret
for key, value in sorted_params:
sign_str += key + str(value)
sign_str += app_secret
sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
return sign
def get_shop_products(page=1, page_size=20, fields=None):
"""
获取京东店铺所有商品信息
:param page: 页码
:param page_size: 每页商品数量
:param fields: 需要返回的商品字段
:return: 商品信息
"""
timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
params = {
"app_key": APP_KEY,
"timestamp": timestamp,
"shop_id": SHOP_ID,
"page": page,
"page_size": page_size
}
if fields:
params["fields"] = fields
params["sign"] = generate_sign(params, APP_SECRET)
try:
response = requests.post(API_URL, data=params)
response.raise_for_status()
return response.json()
except requests.exceptions.RequestException as e:
print(f"请求发生错误: {e}")
except ValueError as ve:
print(f"解析 JSON 数据时发生错误: {ve}")
return None
# 示例调用
if __name__ == "__main__":
result = get_shop_products(page=1, page_size=20, fields="name,price,stock")
if result:
print(result)
在上述代码中，首先定义了生成签名的函数 generate_sign，该函数根据请求参数和应用密钥生成签名。然后定义了 get_shop_products 函数，用于发送请求并获取商品信息。在 get_shop_products 函数中，构造了请求参数，调用 generate_sign 函数生成签名，使用 requests.post 方法发送请求。最后，通过示例调用展示了如何使用该函数获取商品信息。
