京东商品详情接口工程实践：区域价格适配 + 多规格 SKU 归一化 + 分级重试方案（Python 实现）

import requests
import time
import hashlib
import json

class JdItemDetailClient:
    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"
        self.session = requests.Session()

    # 生成接口签名
    def build_sign(self, param_dict):
        sorted_param = sorted(param_dict.items(), key=lambda x: x[0])
        sign_raw = self.app_secret
        for k, v in sorted_param:
            sign_raw += f"{k}{v}"
        sign_raw += self.app_secret
        return hashlib.md5(sign_raw.encode("utf-8")).hexdigest().upper()

    # 获取商品详情
    def get_item_detail(self, sku_id, area_code="1_72_2799_0", max_retry=3):
        params = {
            "app_key": self.app_key,
            "method": "jingdong.item.base.info.get",
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
            "v": "2.0",
            "format": "json",
            "360buy_param_json": json.dumps({"skuId": sku_id, "area": area_code})
        }
        params["sign"] = self.build_sign(params)
        retry_count = 0
        while retry_count < max_retry:
            try:
                resp = self.session.post(self.api_url, data=params, timeout=8)
                result = resp.json()
                # 数据归一化处理
                if "jingdong_item_base_info_response" in result:
                    data = result["jingdong_item_base_info_response"]["result"]
                    clean_data = self.data_normalize(data)
                    return {"success": True, "data": clean_data}
                return {"success": False, "msg": result.get("error_response", {})}
            except Exception as e:
                retry_count += 1
                time.sleep(2 ** retry_count)
        return {"success": False, "msg": "请求多次失败"}

    # 原始数据清洗归一化
    def data_normalize(self, raw):
        return {
            "sku_id": raw.get("skuId"),
            "title": raw.get("name"),
            "shop_name": raw.get("shopName"),
            "is_self": raw.get("isJdSelf"),
            "price": raw.get("jdPrice"),
            "market_price": raw.get("marketPrice"),
            "stock_state": raw.get("stockState"),
            "main_image": raw.get("imageUrl"),
            "spec_list": raw.get("skuSpecList", [])
        }

if __name__ == "__main__":
    client = JdItemDetailClient("你的app_key", "你的app_secret")
    res = client.get_item_detail("100012345678", area_code="1_72_2799_0")
    print(json.dumps(res, ensure_ascii=False, indent=2))