API 开发实战：基于京东开放平台的实时商品数据采集接口实现

APItesterCris

于 2025-05-06 16:13:43 发布

阅读量1.4k

点赞数 16

分类专栏：分享 API接口数据挖掘文章标签： java 数据库前端大数据

本文链接：https://blog.csdn.net/APItesterCris/article/details/147741236

版权

API接口同时被 3 个专栏收录

266 篇文章

订阅专栏

246 篇文章

订阅专栏

数据挖掘

238 篇文章

订阅专栏

在电商行业激烈竞争的当下，实时且准确的商品数据是企业把握市场动态、制定精准营销策略的核心资源。京东开放平台提供了丰富的 API 接口，助力开发者高效获取各类商品数据。本文将通过实战，详细讲解基于京东开放平台实现实时商品数据采集接口的全过程，并附上完整代码，帮助开发者快速掌握相关技术。

一、前期准备：搭建开发基础环境

1.1 注册账号

点击注册按钮，按照页面提示填写企业或个人相关信息，完成账号注册流程。注册时务必保证信息真实有效，以便后续顺利通过审核及获取 API 权限。

1.2 创建应用并获取 API 密钥

注册成功后登录平台，进入控制台找到 “应用管理” 板块，点击创建新应用。填写应用名称、描述、类型等详细信息，提交审核。审核通过后，平台会为应用分配唯一的ApiKey和ApiSecret，这两个密钥是后续调用 API 的关键凭证，需妥善保管，避免泄露。

1.3 熟悉 API 接口文档

仔细研读京东开放平台的 API 接口文档，找到与实时商品数据采集相关的接口，如 “商品详情查询”“商品价格查询” 等接口。深入了解各接口的请求方式（GET/POST）、请求参数、响应数据结构、调用频率限制等内容，为后续开发做好充分准备。

二、接口实现：从参数设置到代码编写

2.1 确定请求参数

以 “商品详情查询” 接口为例，主要请求参数如下：

api_key：即申请应用获得的ApiKey，用于标识应用身份。

method：接口方法名，例如 “jd.item.get” 。

timestamp：当前时间戳（精确到秒），用于保证请求的时效性，防止请求被重放。

param_json：包含商品关键信息的 JSON 字符串，如查询商品详情需指定商品 ID（skuId），示例：{"skuId": "123456789"} 。

sign：签名信息，用于验证请求的合法性，防止数据被篡改。签名生成规则为：将除sign外的所有请求参数，按照参数名的字典序排序后拼接成字符串，再使用ApiSecret作为密钥，通过 HMAC-SHA256 算法加密，最后将结果转换为大写十六进制字符串。

2.2 编写 Python 代码实现接口调用

使用 Python 语言进行开发，借助requests库发送 HTTP 请求，hmac和hashlib库生成签名。示例代码如下：

import hmac
import hashlib
import requests
import time
import json


def generate_sign(api_secret, params):
    """生成签名"""
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    query_string = ''
    for key, value in sorted_params:
        if value is not None:
            query_string += f'{key}{value}'
    sign = hmac.new(api_secret.encode('utf-8'), query_string.encode('utf-8'), hashlib.sha256).hexdigest().upper()
    return sign


def get_jd_item_detail(api_key, api_secret, item_id):
    """获取京东商品详情"""
    method = 'jd.item.get'
    timestamp = str(int(time.time()))
    params = {
        'app_key': api_key,
       'method': method,
        'timestamp': timestamp,
        'param_json': json.dumps({'skuId': item_id})
    }
    sign = generate_sign(api_secret, params)
    params['sign'] = sign
    url = 'https://api.jd.com/routerjson'
    response = requests.get(url, params=params)
    return response.json()


# 替换为自己的ApiKey和ApiSecret
API_KEY = 'your_api_key'
API_SECRET = 'your_api_secret'
# 替换为具体的商品ID
ITEM_ID = '123456789'

result = get_jd_item_detail(API_KEY, API_SECRET, ITEM_ID)
print(result)

2.3 数据解析与处理

京东 API 返回的数据为 JSON 格式，需进行解析提取有用信息。以解析商品名称、价格、库存为例，示例代码如下：

def parse_item_detail(response_data):
    """解析商品详情数据"""
    if response_data.get('code') == '0':
        item_info = response_data['result']['wareInfo']
        name = item_info['name']
        price = item_info['price']['p']
        stock = item_info['stock']['s']
        return {
            'name': name,
            'price': price,
           'stock': stock
        }
    else:
        print(f"请求失败，错误码：{response_data['code']}，错误信息：{response_data['msg']}")
        return None


parsed_result = parse_item_detail(result)
if parsed_result:
    print(parsed_result)

三、调试与优化：保障接口稳定高效运行

3.1 接口调试

签名调试：若出现签名错误，可在生成签名的代码中添加打印语句，输出排序后的参数拼接字符串以及最终生成的签名，与京东开放平台提供的签名示例进行对比，排查问题。

参数调试：检查请求参数是否完整、正确，尤其是商品 ID、时间戳等关键参数。可通过打印请求 URL，手动在浏览器中访问，查看返回结果是否符合预期。

错误码处理：根据 API 返回的错误码（如code字段），参考京东开放平台的错误码文档，定位问题并进行相应处理，例如权限不足时重新申请权限，网络错误时检查网络连接等。

3.2 性能优化

批量请求：若需获取多个商品数据，使用支持批量查询的接口，减少请求次数。修改代码中的param_json参数，传入多个商品 ID，如{"skuId": ["123456789", "987654321"]} 。

异步请求：引入asyncio和aiohttp库实现异步请求，提升高并发场景下的数据采集效率。示例代码如下：

import asyncio
import aiohttp
import hmac
import hashlib
import json
import time


async def generate_sign(api_secret, params):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    query_string = ''
    for key, value in sorted_params:
        if value is not None:
            query_string += f'{key}{value}'
    sign = hmac.new(api_secret.encode('utf-8'), query_string.encode('utf-8'), hashlib.sha256).hexdigest().upper()
    return sign


async def fetch_item_detail(session, api_key, api_secret, item_id):
    method = 'jd.item.get'
    timestamp = str(int(time.time()))
    params = {
        'app_key': api_key,
       'method': method,
        'timestamp': timestamp,
        'param_json': json.dumps({'skuId': item_id})
    }
    sign = await generate_sign(api_secret, params)
    params['sign'] = sign
    url = 'https://api.jd.com/routerjson'
    async with session.get(url, params=params) as response:
        return await response.json()


async def main(api_key, api_secret, item_ids):
    async with aiohttp.ClientSession() as session:
        tasks = [fetch_item_detail(session, api_key, api_secret, item_id) for item_id in item_ids]
        results = await asyncio.gather(*tasks)
        return results


# 替换为自己的ApiKey和ApiSecret
API_KEY = 'your_api_key'
API_SECRET = 'your_api_secret'
# 替换为具体的商品ID列表
ITEM_IDS = ['123456789', '987654321']

loop = asyncio.get_event_loop()
results = loop.run_until_complete(main(API_KEY, API_SECRET, ITEM_IDS))
for result in results:
    print(result)