京东 API 商品详情数据获取：Python 代码实现与接口返回解析

pip install requests

import requests
import hashlib
import time
from urllib.parse import urlencode

class JDAPIClient:
    def __init__(self, app_key, app_secret, access_token):
        self.app_key = app_key
        self.app_secret = app_secret
        self.access_token = access_token
        self.api_url = "https://api.jd.com/routerjson"

    # 京东API MD5签名生成（必须）
    def sign(self, params):
        params_str = "".join([f"{k}{v}" for k, v in sorted(params.items())])
        sign_str = self.app_secret + params_str + self.app_secret
        return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()

    # 通用请求方法
    def request(self, method, params):
        public_params = {
            "method": method,
            "app_key": self.app_key,
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
            "format": "json",
            "v": "2.0",
            "access_token": self.access_token
        }
        # 合并公共参数 + 业务参数
        all_params = {**public_params, **params}
        all_params["sign"] = self.sign(all_params)
        
        try:
            resp = requests.post(self.api_url, data=all_params, timeout=10)
            return resp.json()
        except Exception as e:
            return {"error": str(e)}

# ========== 配置信息（替换为自己的） ==========
APP_KEY = "你的AppKey"
APP_SECRET = "你的AppSecret"
ACCESS_TOKEN = "你的AccessToken"

# 初始化客户端
client = JDAPIClient(APP_KEY, APP_SECRET, ACCESS_TOKEN)

# ============= 1. 单品商品详情 =============
def get_jd_item_detail(sku_id):
    params = {
        "sku_id": sku_id,  # 京东商品ID（必填）
        "fields": "sku_id,title,price,image_url,brand_info,category_info,sku_stock,sku_property"
    }
    return client.request("jingdong.item.read.get", params)

# ============= 2. 批量商品详情（最多20个） =============
def get_jd_item_batch(sku_ids):
    params = {
        "sku_ids": ",".join(sku_ids),  # 逗号分隔，≤20个
        "fields": "sku_id,title,price,image_url,sku_stock"
    }
    return client.request("jingdong.item.list.get", params)

# ============= 调用示例 =============
if __name__ == "__main__":
    # 单品
    detail = get_jd_item_detail("100012345678")
    print("单品详情：", detail)

    # 批量
    # batch_detail = get_jd_item_batch(["100012345678", "100087654321"])
    # print("批量详情：", batch_detail)

{
  "jingdong_item_read_get_response": {
    "result": {
      "item": {
        "sku_id": "100012345678",
        "title": "2025新款平板电脑 高清全面屏 办公学习游戏二合一",
        "price": "2499.00",
        "image_url": "https://img14.360buyimg.com/n1/jfs/t1/206524/28/22345/12345/641234567890a1234.jpg",
        "brand_info": {
          "brand_id": "12345",
          "brand_name": "小米"
        },
        "category_info": {
          "cid1": "1319",
          "cid1_name": "电脑、办公",
          "cid2": "1320",
          "cid2_name": "平板电脑"
        },
        "sku_stock": "现货",
        "sku_property": [
          {
            "property_id": "1234",
            "property_name": "颜色",
            "value_id": "5678",
            "value_name": "深空灰"
          },
          {
            "property_id": "4321",
            "property_name": "内存",
            "value_id": "8765",
            "value_name": "8GB+256GB"
          }
        ]
      },
      "code": 0,
      "msg": "success"
    }
  }
}

{
  "jingdong_item_list_get_response": {
    "result": {
      "items": [
        {
          "sku_id": "100012345678",
          "title": "平板电脑",
          "price": "2499.00",
          "image_url": "https://img14.360buyimg.com/xxx.jpg",
          "sku_stock": "现货"
        },
        {
          "sku_id": "100087654321",
          "title": "无线蓝牙耳机",
          "price": "399.00",
          "image_url": "https://img10.360buyimg.com/yyy.jpg",
          "sku_stock": "现货"
        }
      ],
      "code": 0,
      "msg": "success"
    }
  }
}

{
  "error_response": {
    "code": 401,
    "msg": "签名错误",
    "sub_code": "isv.sign-invalid"
  }
}