当前位置：首页 > news >正文

京东API分类接口实战指南：获取各类商品信息

news 2025/8/26 8:57:25

一、核心接口与权限准备

核心API接口
- 接口名称：jingdong.category.read.find（京东商品分类获取接口）
- 功能：通过父分类ID获取子分类信息，支持构建分类树。
- 请求参数：
  - parentId：父分类ID，默认为0（根分类）。
  - grade：分类级别（0为一级分类，1为二级，2为三级）。
权限申请流程
- 步骤1：注册京东开放平台企业账号，提交资质材料（营业执照、法人身份证扫描件）。
- 步骤2：创建应用，选择“商品详情”或“分类信息”相关API权限包。
- 步骤3：等待审核通过后，获取AppKey和AppSecret，用于后续API调用。

二、API调用实战步骤

1. 生成签名（关键安全步骤）

python

体验AI代码助手

代码解读

复制代码

python 体验AI代码助手代码解读复制代码 python import hashlib def generate_sign(params, app_secret): # 按参数名ASCII升序排序 sorted_params = sorted(params.items(), key=lambda x: x[0]) # 拼接字符串并加密 sign_str = app_secret + ''.join([f"{k}{v}" for k, v in sorted_params]) + app_secret return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

2. 调用分类接口示例

python

体验AI代码助手

代码解读

复制代码

python 体验AI代码助手代码解读复制代码 python import requests import time class JDAPI: def __init__(self, app_key, app_secret): self.app_key = app_key self.app_secret = app_secret self.api_url = "https://api.jd.com/routerjson" def call(self, method, params=None): # 公共参数 common_params = { "app_key": self.app_key, "method": method, "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"), "format": "json", "v": "2.0", "sign_method": "md5" } # 合并参数并生成签名 all_params = {**common_params, **(params or {})} all_params["sign"] = generate_sign(all_params, self.app_secret) # 发送请求 response = requests.post(self.api_url, data=all_params) return response.json() class JDCategoryAPI(JDAPI): def get_categories(self, parent_id=0): return self.call("jingdong.category.read.find", {"parentId": parent_id}) # 使用示例 app_key = "YOUR_APP_KEY" # 替换为实际AppKey app_secret = "YOUR_APP_SECRET" # 替换为实际AppSecret api = JDCategoryAPI(app_key, app_secret) categories = api.get_categories(parent_id=0) # 获取一级分类 print(categories)

3. 高级参数示例（精准筛选）

ini

体验AI代码助手

代码解读

复制代码

ini 体验AI代码助手代码解读复制代码 python # 获取二级分类（父分类ID为1342） categories_level2 = api.get_categories(parent_id=1342) # 获取三级分类（父分类ID为1562） categories_level3 = api.get_categories(parent_id=1562)

三、响应数据解析

典型响应结构：

css

体验AI代码助手

代码解读

复制代码

css 体验AI代码助手代码解读复制代码 json { "jd_category_read_find_response": { "code": "0", "categoryList": [ { "categoryId": "1342", "name": "手机", "parentId": "0", "grade": "0" }, { "categoryId": "1562", "name": "笔记本电脑", "parentId": "0", "grade": "0" } ] } }

关键字段说明：
- categoryId：分类唯一标识符
- name：分类名称
- parentId：父分类ID
- grade：分类级别（0/1/2对应一/二/三级）

四、常见问题与解决方案

签名失败
- 原因：参数排序错误或时间戳格式不正确。
- 解决：检查参数是否按ASCII升序排列，时间戳格式为YYYY-MM-DD HH:mm:ss。
权限不足
- 原因：应用未申请分类API权限。
- 解决：登录开放平台检查权限配置，提交权限升级申请。
数据为空
- 原因：父分类ID错误。
- 解决：确认父分类ID有效性，或尝试使用parentId=0获取根分类。
频率限制
- 原因：触发京东API限流（QPS限制通常为50次/秒）。
- 解决：使用队列（如Celery）管理请求，或申请提高QPS限额。