淘系(包括淘宝、天猫等阿里巴巴集团旗下的电商平台)的商品详情API接口返回的JSON数据中,包含了丰富的商品信息字段。这些字段可能因API版本、请求参数以及商品类型的不同而有所差异,但以下是一些常见的字段:
- 商品基本信息
- id(或num_iid):商品的唯一标识符。
- title:商品的名称或标题。
- price:商品的销售价格,单位通常为元。
- original_price(或market_price):商品的原价,用于表示折扣前的价格。
- image_url(或pic_url):商品的主图或预览图的URL。
- seller_id(或shop_id):卖家的ID或店铺ID。
- seller_name(或nick):卖家的昵称或店铺名称。
- 商品属性
- properties:一个包含商品属性的键值对数组,如颜色、尺寸、材质等。
- name:属性的名称。
- value:属性的具体值。
- properties:一个包含商品属性的键值对数组,如颜色、尺寸、材质等。
- SKU信息
- skus:如果商品有多个SKU(如不同颜色、尺寸的组合),则会返回每个SKU的详细信息。
- sku_id(或outer_id):SKU的唯一标识符。
- sku_price:该SKU的销售价格。
- sku_stock:该SKU的库存数量。
- sku_properties:SKU的属性信息,与商品属性类似,但这里是针对特定SKU的属性。
- skus:如果商品有多个SKU(如不同颜色、尺寸的组合),则会返回每个SKU的详细信息。
- 促销信息
- promotion_info:包括优惠券、满减等促销活动的信息。
- 库存与销量
- stock:商品的库存数量。
- volume(或vol):商品的销售数量。
- 评价信息
- comment_count:商品的评论数量。
- ratings:商品的评分信息,可能包括整体评分、各维度评分等。
- 其他信息
- detail_url:商品在淘宝或天猫上的详情页链接。
- category_id:商品的分类ID。
- brand:商品的品牌信息。
- logistics_info:商品的发货地点或物流信息。
- desc:商品的详细描述或产品介绍。
请注意,以上列出的字段并非所有淘系商品详情API接口都会返回,具体返回的字段取决于你调用的API接口、请求参数以及商品本身的属性。为了获取最准确和最新的信息,建议直接查阅淘系开放平台提供的API文档。
此外,由于API的更新和变化,上述字段列表可能不是最新的。因此,在开发过程中,定期检查API文档以获取最新的字段列表和API使用说明是非常重要的。