一、通用响应顶层结构
1688商品详情API遵循阿里体系统一JSON响应规范，成功与失败请求的顶层字段统一，便于封装通用解析逻辑。
code：状态码，0代表请求成功，非0代表请求失败，可快速判断接口调用结果。
request_id：全局请求唯一标识，用于接口调用异常时的问题排查与链路追踪。
data：业务数据载体，成功响应下包含item_get_response节点，失败响应下包含error_response节点。
sub_code/sub_msg：失败场景下的细分错误码与提示，可精准定位问题，例如isv.invalid-sign代表签名错误、isv.item-not-exist代表商品不存在。
二、商品核心基础信息字段
该部分是商品的核心标识数据，是业务系统识别、关联商品的核心依据。
item_id/productId：商品唯一标识，字符串类型不可为空，是后续商品查询、数据同步的核心主键，需与自身系统商品ID建立映射关系，注意与SKU ID区分。
title：商品标题，最大长度120字符，需过滤表情、特殊占位符等乱码字符，保留标题中的材质、尺寸等核心规格信息，用于后续商品分类展示。
pic_url/mainImage：商品主图URL，返回单个图片地址，多图需解析imageList数组字段，图片链接存在有效期，建议同步下载至本地或云存储避免失效。
detail_url：1688平台商品详情页的完整跳转链接，可直接用于前端跳转或数据溯源。
category_id/categoryId：商品类目ID，整数类型，对应1688平台层级化类目体系，可通过类目映射接口获取完整类目名称，用于业务系统的商品分类归档。
category_name：完整类目路径字符串，例如“男装>T恤>短袖T恤”，可直接用于前端展示无需额外调用类目接口。
brand：商品品牌名称，字符串类型，可用于品牌维度的商品筛选与统计分析。
trade_type：交易类型枚举值，wholesale代表批发模式，retail代表零售模式，可用于区分不同交易场景的业务逻辑。
三、基础交易关联字段
该部分是1688批发场景下的特色基础信息，直接关联采购业务规则。
price：商品展示基准单价，字符串类型保留两位小数，单位为元，对应单SKU商品的统一售价。
price_unit：计价单位，例如“件”“kg”等，用于明确商品的计价维度。
min_order_quantity/moq：最小起订量，整数类型，代表采购该商品的最低下单数量，需同步至自身系统采购规则，避免生成低于起订量的无效订单。
max_order_quantity：最大订购量，整数类型，代表单次下单可采购的商品上限，用于限制大额订单的提交范围。
priceRange：多SKU商品的价格区间字符串，例如“10.00-20.00元”，为所有SKU的最低单价与最高单价的组合展示。
四、基础规格与供应商关联字段
该部分是商品基础信息的延伸内容，支撑前端规格选择与货源识别。
spec_info：商品规格总览对象，包含规格名称（如“颜色&尺码”）和全量可选规格值列表，可直接用于生成前端商品规格选择器。
supplier_info：供应商基础信息对象，包含supplier_id（供应商唯一ID）、supplier_name（店铺全称）、supplier_type（商家类型标识）等核心字段，用于货源筛选与供应商资质识别。
需要我为你提供一份可直接复用的1688商品详情API的Java解析示例代码吗？帮你快速完成数据封装。
