速卖通API接口系列中的item_get接口是用于获取速卖通商品详情数据的接口。以下是该接口的主要参数参考:
一、公共参数
公共参数是调用速卖通API接口时必须包含的一些基础参数,用于身份认证和接口调用。对于item_get接口,公共参数可能包括:
- key:调用key,是调用API接口的凭证,需要以GET方式拼接在URL中。
- secret:调用密钥,与key一起用于接口的身份认证。
- api_name:API接口名称,对于item_get接口,其值为“item_get”。
- cache:可选参数,用于控制是否使用缓存的数据,以提高调用速度。
- result_type:可选参数,用于指定返回数据的格式,如json、xml等。
- lang:可选参数,用于指定返回数据的语言,如简体中文(cn)、英文(en)等。
- version:API版本,用于指定调用接口的版本信息。
二、请求参数
请求参数是调用item_get接口时必须指定的参数,用于指定要获取的商品详情信息。主要的请求参数包括:
- num_iid:商品ID,是商品的唯一标识符,用于在速卖通平台上识别和检索商品。调用item_get接口时,必须指定此参数以获取指定商品的详情信息。
三、响应参数
响应参数是item_get接口返回的数据字段,包含了商品的详细信息。主要的响应参数包括:
- num_iid:商品ID,与请求参数中的num_iid相对应。
- title:商品标题,是商品的名称或简短描述。
- price:商品价格,是商品的当前售价。
- original_price:原价或市场参考价,有助于消费者了解商品的折扣程度。
- discount:折扣信息,可能是折扣率或具体的折扣金额。
- sale_count:销量,表示商品的销售数量。
- rating_star:商品评分,表示商品的平均评分。
- rating_count:评分数量,表示针对商品的评价数量。
- shipping:运输信息,包含运输方式列表、是否免运费等。
- description:商品描述,可能包括产品特点、用途、规格等详细信息。
- images:商品图片链接列表,用于展示商品的外观。
- sku_list:SKU列表,每个SKU包含ID、属性、价格和库存数量等信息。
- brand:品牌名称。
- detail_url:商品详情页的链接地址。
- seller_info:卖家信息,包括卖家昵称、所在城市、信用等级、评分等。
此外,响应参数还可能包括一些其他字段,如包装重量(item_weight)、包装尺寸(item_size)、发货地(location)、物流费用(post_fee)、快递费用(express_fee)、EMS费用(ems_fee)、是否有折扣(has_discount)、商品视频(video)等。
总的来说,速卖通API接口系列中的item_get接口提供了丰富的商品详情信息,可以帮助开发者或商家实现商品搜索、推荐、展示等功能,并基于商品数据制定营销策略、进行价格监控和销售趋势分析等。在调用接口时,需要根据实际情况填写正确的公共参数和请求参数,并正确处理接口返回的响应参数。