1688商品详情API返回值中的商品基本信息详解

在阿里巴巴的1688平台上，商品详情API是用于获取特定商品详细信息的接口。这些API通常返回丰富的数据，包括商品的基本信息、价格、库存、规格、物流信息、供应商信息等。不过，具体的返回值结构可能会根据API的版本和调用方式有所不同。以下是一个简化的商品基本信息详解，旨在提供一个大致的框架和常见的字段说明：

商品基本信息

1. 商品ID (product_id 或 itemid): 商品的唯一标识符，用于在平台上唯一识别一个商品。

2. 商品标题 (title 或 subject): 商品的名称或标题，是用户搜索和识别商品的重要依据。

3. 商品图片URL (image_urls 或 images): 包含商品图片的URL列表，通常包括主图、详情图等。

4. 价格信息：

   • 一口价 (price 或 min_price): 商品的标准售价，不含任何优惠或折扣。
   • 促销价 (promotion_price 或类似字段): 如果商品有促销活动，则显示促销后的价格。
   • 价格区间 (price_range): 如果商品有多个规格或SKU，可能显示价格区间。

5. 库存信息 (stock 或 quantity): 显示商品的库存数量，可能包括总库存、可售库存等。

6. 销量 (sales 或 sold_quantity): 商品的累计销量，有时也提供近期销量数据。

7. 评价信息 (ratings 或 reviews): 可能包括评价数量、评分（如平均分）、好评率等。

8. 规格参数 (specs 或 attributes): 商品的规格参数列表，如尺寸、颜色、材质等，具体字段根据商品类型而异。

9. SKU信息 (skus 或 variants): 如果商品有多个SKU（如不同颜色、尺寸等），则每个SKU会有详细的信息，包括SKU ID、价格、库存、图片等。

10. 发货信息 (freight_template_id 或 shipping_info): 发货模板ID或发货相关的信息，如运费模板、发货地等。

11. 退换货政策 (return_policy): 商品的退换货政策描述。

12. 商品描述 (description 或 detail): 商品的详细描述，通常包含文字、图片、视频等多媒体内容。

13. 供应商信息 (supplier_id, supplier_name, contact_info): 供应商的唯一标识符、名称及联系方式。

1688.item_get

公共参数

请求地址: 

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=610947572360

参数说明：num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据

响应参数

Version: Date:

名称	类型	必须	示例值	描述
item	item[]	0		宝贝详情数据

响应示例