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

74 阅读2分钟

接口功能

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

图片.png 点击获取key和secret 接口基础信息 接口地址‌: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 = "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、采购系统等企业级应用中。实际开发时请以最新版官方文档为准。