Python代码获取京东SKU商品信息API接口（jd.item_sku）实战指南

在电商领域，获取商品的SKU（Stock Keeping Unit，库存进出计量的基本单元）信息对于库存管理、价格监控、商品推荐等场景至关重要。京东作为国内知名的电商平台，提供了丰富的API接口供开发者使用，其中jd.item_sku接口可以方便地获取商品的SKU信息。本文将详细介绍如何使用Python代码调用京东的jd.item_sku接口，获取商品的详细SKU信息。

一、前期准备

（一）注册京东开放平台账号

访问京东开放平台官网，注册开发者账号并完成实名认证。这是使用京东API的必要步骤。

（二）创建应用并获取API权限

1. 登录京东开放平台，进入“我的应用”页面。

2. 点击“创建应用”，填写应用名称、描述等信息。

3. 在应用的“接口管理”中，找到jd.item_sku接口，申请调用权限。

4. 申请通过后，获取App Key和App Secret，这是调用API的必要凭证。

二、接口调用实战

（一）接口说明

jd.item_sku接口用于获取商品的SKU信息，包括商品的基本信息、价格、库存、规格等。以下是接口的基本参数和返回值说明。

请求参数：

• skuId：商品的SKU ID（必填）。

• fields：需要返回的字段列表，如basicInfo、price、stock等（可选，默认返回所有字段）。

返回值：

• basicInfo：商品的基本信息，包括标题、图片等。

• price：商品的价格信息。

• stock：商品的库存信息。

• specs：商品的规格信息。

（二）Python代码示例

以下是使用Python调用jd.item_sku接口的完整代码示例：

import requests
import hashlib
import time

class JD_API:
    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 sign(self, params):
        """生成签名"""
        sorted_params = sorted(params.items())
        sign_str = self.app_secret
        for k, v in sorted_params:
            sign_str += f"{k}{v}"
        sign_str += self.app_secret
        return hashlib.md5(sign_str.encode()).hexdigest().upper()

    def get_sku_info(self, sku_id, fields=None):
        """调用 jd.item_sku 接口获取商品信息"""
        params = {
            "method": "jd.item_sku.get",
            "app_key": self.app_key,
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
            "v": "2.0",
            "format": "json",
            "skuId": sku_id,
        }

        if fields:
            params["fields"] = fields

        params["sign"] = self.sign(params)

        try:
            response = requests.get(self.api_url, params=params)
            response.raise_for_status()
            data = response.json()

            if "error_response" in data:
                error = data["error_response"]
                return {
                    "success": False,
                    "error_code": error["code"],
                    "error_msg": error["msg"]
                }

            return {
                "success": True,
                "data": data["jd_item_sku_get_response"]["item"]
            }

        except requests.exceptions.RequestException as e:
            return {
                "success": False,
                "error_msg": f"请求异常: {str(e)}"
            }

if __name__ == "__main__":
    APP_KEY = "your_app_key"
    APP_SECRET = "your_app_secret"

    jd_api = JD_API(APP_KEY, APP_SECRET)

    result = jd_api.get_sku_info(
        sku_id="123456789",
        fields="basicInfo,price,stock"
    )

    if result["success"]:
        print("获取商品信息成功:")
        print(result["data"])
    else:
        print(f"获取商品信息失败: {result.get('error_msg', '未知错误')}")
        if "error_code" in result:
            print(f"错误代码: {result['error_code']}")

（三）代码解析

1. 签名生成：京东API要求对请求参数进行签名，以确保请求的安全性。签名算法是将所有参数按字母顺序排序后，拼接app_secret，然后使用MD5算法生成签名。

2. 请求参数：除了API特定参数外，还需要传入公共参数如app_key、timestamp等。

3. 错误处理：代码中包含了对HTTP请求异常和API返回错误的处理。

4. 字段过滤：通过fields参数可以指定需要返回的字段，减少数据传输量。

三、返回数据解析

（一）成功响应示例

{
  "jd_item_sku_get_response": {
    "item": {
      "basicInfo": {
        "title": "商品标题",
        "picUrl": "商品图片链接"
      },
      "price": {
        "currentPrice": "当前价格",
        "originalPrice": "原价"
      },
      "stock": {
        "stockNum": "库存数量"
      },
      "specs": [
        {
          "specName": "规格名称",
          "specValue": "规格值"
        }
      ]
    }
  }
}

（二）失败响应示例

{
  "error_response": {
    "code": "400",
    "msg": "Invalid parameter"
  }
}

四、常见问题及解决方法

（一）签名错误

问题：签名错误，通常是sign参数不正确。

解决方法：

• 检查app_secret是否正确。

• 确保参数排序正确，按照字母顺序排列。

• 确保签名算法正确，使用MD5算法。

（二）权限不足

问题：权限不足，通常是code返回403。

解决方法：

• 检查是否已申请jd.item_sku接口的调用权限。

• 确保应用的权限未被限制。

（三）参数错误

问题：请求参数错误，通常是code返回400。

解决方法：

• 检查请求参数是否符合API的要求。

• 确保所有必填参数都已正确传递。

五、总结

通过本文的介绍，你应该已经掌握了如何使用Python代码调用京东的jd.item_sku接口，获取商品的SKU信息。在实际开发中，注意错误处理和日志记录，可以提高开发效率和代码的稳定性。

如遇任何疑问或有进一步的需求，请随时与我私信或者评论联系。