京东工业平台商品详情接口调用指南

接口功能

京东工业平台商品详情接口（industrial.product.detail.get）用于获取指定工业品类商品的详细信息，包括商品标题、规格参数、价格、库存等核心数据。本指南重点演示获取商品标题的请求流程及代码实现。

点击获取key和secret

接口基础信息
接口地址‌：https://api.jd.com/routerjson（生产环境）
请求方式‌：POST
数据格式‌：JSON
认证方式‌：API Key + Signature
请求参数说明
参数名    类型    是否必填    描述
method    String    是    接口方法名：industrial.product.detail.get
access_token    String    是    OAuth2.0授权令牌
app_key    String    是    开发者应用标识
timestamp    String    是    请求时间戳（格式：yyyy-MM-dd HH:mm）
v    String    是    API版本号（例：2.0）
sign    String    是    请求签名
sku_id    Long    是    商品SKU ID（唯一标识）
响应数据结构（关键字段）
json
Copy Code
{
  "code": 0,
  "message": "success",
  "result": {
    "skuId": 123456789,
    "title": "工业级3M防尘口罩 KN95 防颗粒物 50只/盒",
    "category": "安全防护 > 呼吸防护",
    "specs": [
      {"name": "防护等级", "value": "KN95"},
      {"name": "数量", "value": "50只/盒"}
    ],
    "price": {
      "unitPrice": 89.90,
      "currency": "CNY"
    },
    "stock": 500
  }
}

Python调用示例
python
Copy Code
import requests
import hashlib
import time

def get_jd_industrial_product(sku_id):
    # 基础配置
    app_key = "YOUR_APP_KEY"
    app_secret = "YOUR_APP_SECRET"
    api_url = "https://api.jd.com/routerjson"
    
    # 构造参数
    params = {
        "method": "industrial.product.detail.get",
        "app_key": app_key,
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
        "v": "2.0",
        "sku_id": sku_id
    }

    # 生成签名（示例简化版）
    sign_str = f"{app_secret}{params['timestamp']}{app_key}"
    params['sign'] = hashlib.md5(sign_str.encode()).hexdigest().upper()

    # 发送请求
    headers = {"Content-Type": "application/json"}
    response = requests.post(api_url, json=params, headers=headers)
    
    # 处理响应
    if response.status_code == 200:
        data = response.json()
        if data['code'] == 0:
            product_title = data['result']['title']
            print(f"商品标题：{product_title}")
            return product_title
        else:
            print(f"接口错误：{data['message']}")
    else:
        print(f"HTTP请求失败，状态码：{response.status_code}")

# 调用示例
if __name__ == "__main__":
    get_jd_industrial_product(123456789)

注意事项
权限申请‌：需提前在京东工业平台完成企业认证并申请API权限
频率限制‌：默认每秒5次请求，超出将返回429错误
签名算法‌：正式环境需使用官方指定的签名算法（本例为简化版）
错误处理‌：建议增加重试机制和异常捕获
数据缓存‌：高频调用建议缓存静态数据（如商品标题）

通过此接口可快速集成京东工业品的商品数据到ERP、采购系统等企业级应用中。实际开发时请以最新版官方文档为准。