京东商品属性API数据解析：颜色、尺寸与材质

一、核心API接口与调用流程

1. 接口选择
   • 商品详情API：jingdong.ware.get 或 jd.item.detail.get，通过商品ID（wareId/sku_id）获取完整属性。
   • 商品搜索API：jingdong.ware.search，通过关键词获取商品列表及基础属性。
   • SKU属性接口：直接查询SKU（如颜色、尺寸组合）的详细参数。
2. 调用步骤
   • 注册与认证：在京东开放平台注册开发者账号，创建应用获取AppKey和AppSecret，申请商品详情API权限。
   • 构造请求：
     • 必填参数：商品ID（如wareId=100060000001）、字段列表（如field=title,price,attributes）。
     • 签名生成：按参数ASCII排序后拼接，首尾加AppSecret，MD5加密（部分接口用HMAC-SHA256）。
     • 请求方式：支持GET/POST，URL示例：https://api.jd.com/routerjson?method=jingdong.ware.get&app_key=XXX&wareId=100060000001...
   • 响应解析：返回JSON结构，核心字段位于wareInfo或sku_info中。

二、属性字段解析

1. 颜色（Color）
   • 位置：attributes数组或sku_info的attributes字段。
   • 示例：

     json

     "attributes": [

     {"name": "颜色", "values": ["红色", "蓝色", "白色"]}

     ]

     或

     json

     "sku_info": [

     {"sku_id": "100012345678", "attributes": "颜色:红色;尺寸:M", "price": "299.00"}

     ]

2. 尺寸（Size）
   • 位置：同颜色，常与颜色组合在attributes中。
   • 示例：

     json

     "attributes": [

     {"name": "尺寸", "values": ["S", "M", "L", "XL"]}

     ]

3. 材质（Material）
   • 位置：attributes或商品描述字段（如desc）。
   • 示例：

     json

     "attributes": [

     {"name": "材质", "values": ["棉95%", "涤纶5%"]}

     ]

三、代码实现示例（Python）

python

import requests

import hashlib

import json

class JDAPI:

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 generate_sign(self, params):

sorted_params = sorted(params.items(), key=lambda x: x[0])

sign_str = self.app_secret + ''.join([f"{k}{v}" for k, v in sorted_params]) + self.app_secret

return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

def get_item_detail(self, ware_id):

params = {

"method": "jingdong.ware.get",

"app_key": self.app_key,

"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),

"format": "json",

"v": "2.0",

"wareId": ware_id,

"field": "title,price,attributes"

}

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

response = requests.get(self.api_url, params=params)

return response.json()

# 使用示例

if __name__ == "__main__":

app_key = "YOUR_APP_KEY"

app_secret = "YOUR_APP_SECRET"

ware_id = "100060000001"

jd_api = JDAPI(app_key, app_secret)

item_data = jd_api.get_item_detail(ware_id)

# 解析颜色、尺寸、材质

if "wareInfo" in item_data:

attributes = item_data["wareInfo"].get("attributes", [])

for attr in attributes:

if attr["name"] == "颜色":

colors = attr.get("values", [])

elif attr["name"] == "尺寸":

sizes = attr.get("values", [])

elif attr["name"] == "材质":

materials = attr.get("values", [])

print(f"颜色: {colors}, 尺寸: {sizes}, 材质: {materials}")

四、注意事项

1. 权限与限制：
   • 部分字段（如销量、评价）需企业认证或付费权限。
   • 调用频率限制：默认100次/分钟，VIP账号可提升至500次/分钟。
   • 需配置IP白名单，避免恶意调用。
2. 数据结构差异：
   • 不同商品类别属性结构可能不同（如服装vs电子产品），需动态解析。
   • 多SKU商品需遍历sku_info数组获取各规格属性。
3. 合规性：
   • 禁止爬虫抓取，必须使用官方API。
   • 敏感信息需脱敏处理，遵循京东数据使用规范。

通过以上流程，可高效获取并解析京东商品的颜色、尺寸和材质属性，适用于电商数据分析、竞品监控等场景。建议定期查阅京东开放平台最新文档，确保接口调用符合规范。