揭秘速卖通aliexpress.item_get API：商品详情数据全面剖析

速卖通（AliExpress）的aliexpress.item_get API是一个用于获取商品详情数据的强大工具。以下是对该API的全面剖析，包括其主要功能、返回值、使用步骤以及注意事项。

主要功能

• 获取商品详细信息：通过调用aliexpress.item_get API，开发者可以获取速卖通平台上商品的详细信息，包括但不限于商品的标题、描述、价格、库存、图片等。

返回值详解

• request_id：请求的唯一标识符，用于追踪和调试。
• item：商品详情的主要部分，包含以下子字段：
  • product_id：商品ID。
  • title：商品标题。
  • price：当前售价。
  • original_price：原价或市场参考价。
  • discount：折扣率或折扣金额（取决于具体的返回格式）。
  • sale_count：销量，通常以“1000+”的形式展示。
  • rating_star：商品评分，如4.5星、4.8星等。
  • rating_count：评分数量。
  • shipping：运输信息，包含是否免运费（free_shipping）和运输方式列表（shipping_methods）。
  • description：商品描述。
  • sku_list：SKU列表，每个SKU包含ID、属性、价格和库存数量。
  • images：商品图片链接列表。
  • ...：其他可能的字段，如颜色、尺寸、重量、品牌等。
• error：如果请求失败，此字段将包含错误信息。在成功的请求中，此字段通常为null。

item_get-获得aliexpress商品详情 

aliexpress.item_get

公共参数

请求地址: https://api-gw.onebound.cn/aliexpress/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=1005005586923234

参数说明：num_iid:aliexpress商品ID

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	32667038134	商品ID
title	String	0	女装T恤短袖吸湿快速干燥健身T恤女装上衣	商品标题
desc_short	String	0		商品简介
price	String	0	4.35-4.68	价格
total_price	Int	0	0
suggestive_price	Int	0	0
orginal_price	String	0	6.21-6.68	原价
nick	String	0	SILVERCELL SILVERCELL Store	买卖方昵称
num	Int	0	1799	可购买商品数量
min_num	Int	0	0
detail_url	String	0	https://www.aliexpress.com/item//32667038134.html	商品链接
pic_url	String	0	https://ae01.alicdn.com/kf/HTB12r_yabEF6uJjSZFOq6xUvVXa1/Women-T-Shirt-Short-Sleeves-Hygroscopic-Quick-Drying-Fitness-T-shirt-Women-Top-Clothes.jpg	商品图片
brand	String	0		品牌名称
brandId	Bigint	0		品牌ID
rootCatId	Bigint	0	100003109	顶级分类ID
cid	Bigint	0
crumbs	Mix	0	{"100003109": "女性着装", "100003127": "T恤", "200000785": "上衣和T恤"}	导航菜单
created_time	Date	0		创建时间
modified_time	Date	0		修改时间
delist_time	Date	0		删除时间
desc	String	0
desc_img	Mix	0	[]	商品描述图片
item_imgs	Mix	0	[{"url": "https://ae01.alicdn.com/kf/HTB12r_yabEF6uJjSZFOq6xUvVXa1/Women-T-Shirt-Short-Sleeves-Hygroscopic-Quick-Drying-Fitness-T-shirt-Women-Top-Clothes.jpg"}]	商品图片
item_weight	Float	0	0.25	包装重量
item_size	String	0	22|18|20	包装尺寸
location	String	0		发货地
post_fee	Float	0	6.00	物流费用
express_fee	Float	0	6.00	快递费用
ems_fee	Float	0	6.00	EMS费用
shipping_to	String	0		发货至
has_discount	Boolean	0		是否有折扣
video	Mix	0	[]	商品视频
is_virtual	Boolean	0
sample_id	Bigint	0		商品风格标识ID
is_promotion	Boolean	0
props_name	String	0	14:193:Color:Black;5:361385:Size:L	商品属性名
prop_imgs	Mix	0	{"prop_img": [{"properties": "14:193", "url": "https://ae01.alicdn.com/kf/HTB1Q9GWJVXXXXXoXXXXq6xXFXXXp/Women-T-Shirt-Short-Sleeves-Hygroscopic-Quick-Drying-Fitness-T-shirt-Women-Top-Clothes.jpg"}]}	商品属性图片列表
property_alias	String	0	14:193:Black;5:361385:L	商品属性别名
props	Mix	0	[{ "name": "上衣类型","value": "T恤" }]	商品详情
total_sold	Int	0	110	总销量
skus	Mix	0	{"sku": [{"price": "4.61", "orginal_price": "6.58", "properties": "14:193;5:100014064", "properties_name": "14:193:Color:Black;5:100014064:Size:L", "quantity": 100, "sku_id": "12000036569570278"}]	商品规格信息
seller_id	Bigint	0		卖家ID
sales	Int	0		销量
shop_id	Bigint	0		店铺ID
props_list	Mix	0	{"Color:Black": ":","Size:L": ":"}	商品属性
seller_info	Mix	0	{ "nick": "", "city": " China ", "level": "", "rate": "", "score": "", "delivery_score": "", "item_score": "", "shop_type": "", "user_num_id": "", "sid": "206074139", "title": "I", "zhuy": "//www.aliexpress.com/store/933191", "menu": []}	卖家信息
tmall	Boolean	0	false	是否天猫
error	String	0		错误信息
warning	String	0		警告信息
url_log	Mix	0
score	Float	0	4.8	商品评分
votes	Int	0	49	评分人数
stuff_status	String	0
shopinfo	Mix	0	{"shop_name": ""}	店铺信息
promo_type	String	0
shop_item	Mix	0	[]
relate_items	Mix	0	[]
packaging	Mix	0	[{ "name": "Package Size","value": "22cm x 18cm x 20cm (8.66in x 7.09in x 7.87in)"}]	包装信息
current_lang	String	0	en
currency_code	String	0	USD
props_img	Mix	0	{"14:193": "https://ae01.alicdn.com/kf/HTB1Q9GWJVXXXXXoXXXXq6xXFXXXp/Women-T-Shirt-Short-Sleeves-Hygroscopic-Quick-Drying-Fitness-T-shirt-Women-Top-Clothes.jpg"}	属性图片

使用步骤

1. 注册与授权：
   • 在速卖通开放平台注册并创建应用，获取App Key和App Secret等信息。
   • 使用获取到的App Key和App Secret进行签名和认证，获取Access Token。
2. 调用接口：
   • 调用开放平台提供的商品详情接口，传入商品ID作为参数。
   • 支持HTTP POST和GET请求方式，开发者可以根据实际需求选择合适的请求方法。
3. 接收与解析数据：
   • 接口会返回一个JSON格式的数据，包含了请求商品的各类信息。
   • 开发者需要解析这个JSON数据，以获取所需的商品详情。