京东商品属性的详细api数据解析：颜色、尺寸与材质

京东商品属性（颜色、尺寸、材质）的API数据解析需通过京东开放平台提供的商品详情API实现，具体流程及技术细节如下：

一、核心接口与调用前提

接口选择
- 商品详情API ：如jingdong.ware.get或jd.item.detail.get，通过商品ID（wareId/sku_id）获取完整属性。
- SKU属性接口：直接查询SKU组合的详细参数（如颜色+尺寸组合）。
- 商品搜索API ：如jingdong.ware.search，通过关键词获取商品列表及基础属性。
前置准备
- 注册认证 ：在京东开放平台注册开发者账号，完成企业资质认证（需营业执照），创建应用获取AppKey和AppSecret。
- 权限申请：在应用管理页面申请"商品详情查询"权限（个人开发者默认开通基础权限）。

二、数据解析逻辑

属性字段位置
- 颜色/尺寸/材质 ：位于返回JSON的attributes数组中，每个属性对象包含name（属性名）和values（属性值列表）。
- 示例结构 ：
  复制代码
  json
  复制代码
```
`"attributes": [
  {"name": "颜色", "values": ["红色", "蓝色", "白色"]},
  {"name": "尺寸", "values": ["S", "M", "L", "XL"]},
  {"name": "材质", "values": ["棉95%", "涤纶5%"]}
]`
```
- SKU级属性 ：部分接口返回sku_info数组，每个SKU对象包含attributes字段（如"颜色:红色;尺寸:M"）。
关键参数说明
- 必填参数 ：wareId（商品ID）、field（返回字段列表，如title,price,attributes）。
- 公共参数 ：app_key、timestamp（与服务器时间差≤5分钟）、v（接口版本，如2.0）、sign（签名）。
- 签名生成 ：按参数ASCII码排序后拼接字符串，首尾添加AppSecret，通过MD5或HMAC-SHA256加密生成大写签名。

三、调用示例（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}")`

四、注意事项

频率限制 ：单接口每分钟调用≤5次，超频返回错误码1002，需设置重试机制（如指数退避）。
数据时效性：价格/库存实时更新（延迟≤3秒），商品描述等静态数据建议缓存。
错误处理 ：常见错误码如1001（参数缺失）、3005（商品不存在），需结合日志排查。
安全规范 ：AppSecret需存储在服务器端，禁止硬编码；AccessToken有效期30天，需定期刷新。

通过上述流程，可高效解析京东商品的颜色、尺寸与材质属性，支撑电商运营、数据分析等场景需求。建议定期关注京东开放平台文档更新，确保代码兼容性。