速賣通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接口提供了豐富的商品詳情信息,可以幫助開發者或商家實現商品搜索、推薦、展示等功能,并基于商品數據制定營銷策略、進行價格監控和銷售趨勢分析等。在調用接口時,需要根據實際情況填寫正確的公共參數和請求參數,并正確處理接口返回的響應參數。