京东商品详情数据接口（JD.item_get）丨京东API接口代码指南

京东商品详情数据接口（JD.item_get）允许开发者获取京东商品的详细信息，包括商品标题、价格、品牌、规格、图片等内容。这些数据对于电商数据分析、竞品分析、商品比价等应用场景非常有帮助。

1. 前期准备

   • 注册开发者账号：需要在京东开放平台（open.jd.com/>）注册成为开发者。
   • 创建应用：登录后，在开放平台创建应用，获取 App Key 和 App Secret。这两个凭证用于对 API 请求进行身份验证。
   • 申请接口权限：在应用管理界面中，申请商品详情数据接口（JD.item_get）的使用权限。京东会对申请进行审核，审核通过后才能正式使用该接口。

2. 接口请求参数

   • 公共参数：

     • app_key：复制Taobaoapi2014威新申请应用时获得的 App Key，用于标识应用身份。
     • method：接口方法名，对于获取商品详情接口，此处为 “JD.item_get”。
     • timestamp：请求时间戳，格式为 yyyy - MM - dd HH:mm:ss，用于验证请求的时效性。
     • v：API 版本号，根据京东开放平台的规定填写。
     • sign：签名，通过特定的加密算法对请求参数进行签名，用于验证请求的合法性。签名算法通常会涉及 App Key 和 App Secret。

   • 业务参数：

     • skuId：商品的唯一标识（库存保有单位），是获取商品详情必不可少的参数。

3. 签名生成示例（Python）

 import hashlib  import time   def generate_sign(app_key, app_secret, params):  # 将参数按照字典序排序并拼接成字符串  sorted_params = sorted(params.items())  param_str = ''  for key, value in sorted_params:  param_str += str(key) + str(value)  # 加入App Secret  param_str += app_secret  # 使用MD5进行加密（京东可能有其他加密要求，具体看文档）  sign = hashlib.md5(param_str.encode('utf - 8')).hexdigest()  return sign   # 示例参数  app_key = 'YOUR_APP_KEY'  app_secret = 'YOUR_APP_SECRET'  skuId = '123456789'  timestamp = time.strftime('%Y - %m - %d %H:%M:%S', time.localtime())  v = '1.0'  params = {  'app_key': app_key,  'method': 'JD.item_get',  'timestamp': timestamp,  'v': v,  'skuId': skuId  }  sign = generate_sign(app_key, app_secret, params)  params['sign'] = sign 

5. 接口请求示例（Python）

 import requests  demo url :c0b.cc/R4rbK2   # 假设params已经包含了所有的请求参数（包括签名）  url = ''  response = requests.get(url, params=params)  data = response.json()  print(data) 

6. 响应数据处理

   • 接口返回的数据一般是 JSON 格式。以下是一个简化的响应数据示例：

 {  "result": {  "skuId": "123456789",  "productName": "京东商品名称",  "price": {  "price": "99.99",  "originalPrice": "109.99"  },  "brand": {  "name": "品牌名称"  },  "image": {  "mainImage": "https://image.jd.com/商品主图.jpg"  },  "specifications": [  {  "name": "规格名称1",  "value": "规格值1"  },  {  "name": "规格名称2",  "value": "规格值2"  }  ]  },  "success": true,  "errorCode": ""  } 

• 可以使用 Python 的 JSON 解析库（如json模块）对返回数据进行解析，然后提取所需的商品详情信息。例如，要获取商品价格和名称：

 if data.get('success'):  product_name = data['result']['productName']  price = data['result']['price']['price']  print("商品名称:", product_name)  print("商品价格:", price)  else:  print("获取商品详情失败，错误码:", data.get('errorCode')) 

7. 注意事项

   • 遵守接口使用规则：严格遵守京东开放平台的接口使用规则，包括但不限于请求频率限制、数据使用范围等。
   • 数据更新频率：注意商品详情数据的更新频率，有些数据可能不会实时更新，需要根据具体业务场景考虑数据的时效性。
   • 错误处理：完善错误处理机制，当接口返回错误码（如请求参数错误、权限不足等）时，能够正确处理并给出友好的提示。