京东开放平台的item_get接口是获取商品详情的核心工具，广泛应用于电商分析、比价系统、商品监控等场景。本文将全面讲解该接口的对接流程、使用技巧和最佳实践，帮助开发者快速掌握从入门到精通的全过程。
一、接口基础认知
二、对接前置准备
三、接口调用流程
四、代码实现示例（Python）
import requests
import hashlib
import time
import json
class JdItemApi:
def __init__(self, app_key, app_secret):
self.app_key = app_key
self.app_secret = app_secret
self.url = "https://api.jd.com/routerjson" # 正式环境
# 沙箱环境：https://sandbox-api.jd.com/routerjson
def generate_sign(self, params):
"""生成签名"""
# 按参数名ASCII排序
sorted_params = sorted(params.items(), key=lambda x: x[0])
# 拼接参数
sign_str = ""
for key, value in sorted_params:
sign_str += f"{key}={value}&"
# 去除最后一个&，并拼接app_secret
sign_str = sign_str[:-1] + self.app_secret
# MD5加密并转为大写
sign = hashlib.md5(sign_str.encode()).hexdigest().upper()
return sign
def item_get(self, sku_id, fields="skuId,skuName,price,stock,mainImgUrl"):
"""
获取商品详情
:param sku_id: 商品SKU ID
:param fields: 需要返回的字段，多个字段用逗号分隔
:return: 商品详情数据
"""
# 组装参数
params = {
"app_key": self.app_key,
"method": "jd.union.open.goods.detail.query", # 京东商品详情接口
"format": "json",
"v": "1.0",
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
"param_json": json.dumps({
"skuIds": [sku_id],
"fields": fields
})
}
# 生成签名
params["sign"] = self.generate_sign(params)
try:
# 发送POST请求
response = requests.post(
self.url,
data=params,
headers={"Content-Type": "application/x-www-form-urlencoded"},
timeout=10
)
result = json.loads(response.text)
# 处理错误响应
if "error_response" in result:
error = result["error_response"]
return {
"success": False,
"error_code": error.get("code"),
"error_msg": error.get("zh_desc") or error.get("en_desc")
}
# 提取商品数据
if "jd_union_open_goods_detail_query_response" in result:
data = result["jd_union_open_goods_detail_query_response"]["result"]
data_json = json.loads(data)
if data_json.get("code") == 200 and data_json.get("data"):
return {
"success": True,
"data": data_json["data"][0] # 返回第一个商品的数据
}
else:
return {
"success": False,
"error_msg": data_json.get("message", "获取商品信息失败")
}
return {"success": False, "error_msg": "未知响应格式"}
except Exception as e:
return {"success": False, "error_msg": f"请求异常: {str(e)}"}
# 使用示例
if __name__ == "__main__":
# 替换为自己的app_key和app_secret
APP_KEY = "your_app_key"
APP_SECRET = "your_app_secret"
# 初始化API客户端
api = JdItemApi(APP_KEY, APP_SECRET)
# 调用接口，获取商品SKU为100012345678的详情
result = api.item_get(
sku_id="100012345678",
fields="skuId,skuName,price,promotionPrice,stock,mainImgUrl,shopName,brandName"
)
if result["success"]:
item = result["data"]
print(f"商品ID: {item.get('skuId')}")
print(f"商品名称: {item.get('skuName')}")
print(f"商品价格: {item.get('price')} 元")
print(f"促销价格: {item.get('promotionPrice')} 元")
print(f"库存状态: {item.get('stock')}")
print(f"店铺名称: {item.get('shopName')}")
print(f"品牌名称: {item.get('brandName')}")
print(f"商品主图: {item.get('mainImgUrl')}")
else:
print(f"获取失败: {result['error_msg']} (错误码: {result.get('error_code')})")