1688 商品詳情數據接口(1688.item_get)是阿里巴巴提供給開發者的 API 接口,用于獲取 1688 網站上商品的詳細信息. 以下是對該接口的詳細介紹:
調用前準備
- 注冊成為開發者:需要在阿里巴巴開放平臺注冊賬號,并創建一個應用,以獲取 API 調用所需的憑證,如 App Key 和 App Secret.請求demo示例地址:c0b.cc/R4rbK2 。
- 申請 API 調用權限:根據應用需求,申請相應的 API 調用權限,可能需要經過阿里巴巴的審核和授權.
請求參數
- app_key:必填參數,用于標識應用程序,需向 1688 申請唯一的 app_key.
- format:必填參數,返回數據的格式,通常為 json.
- timestamp:必填參數,請求的時間戳,防止請求被緩存或重復執行.
- nonce:必填參數,隨機字符串,用于增加請求的安全性.
- sign_method:必填參數,簽名方法,目前僅支持 RSA 簽名方法。
- sign:必填參數,簽名結果,確保請求的安全性,防止被篡改.
- access_id:必填參數,1688 分配給每個開發者的唯一標識符.
- fields:可選參數,商品詳情頁需要展示的字段,如商品名稱、價格、庫存、圖片等,可根據需要選擇.
- key 或 num_iid:可選參數,商品的 key 值或 ID,用于指定獲取哪個商品的詳情信息.
- sales_data:可選參數,設置為 1 時可獲取近 30 天成交數據.
- agent:可選參數,設置為 1 時可獲取 1688 分銷代發價格數據.
返回結果
成功調用接口后,將收到一個包含商品詳情的 JSON 響應,響應中包含的字段與請求參數中 fields 指定的字段相對應1. 以下是一些常見的返回字段:
- num_iid:商品 ID。
- title:商品名稱。
- desc_short:商品簡短描述。
- price:商品價格。
- total_price:商品總價。
- suggestive_price:建議價格。
- orginal_price:原價。
- nick:賣家昵稱。
- num:商品庫存數量。
- detail_url:商品詳情頁的 URL。
- pic_url:商品圖片的 URL。
- brand:品牌名稱。
- brandid:品牌 ID。
- rootcatid:根類目 ID。
- cid:類目 ID。
- desc:商品詳細描述。
- item_imgs:商品圖片列表。
- item_weight:商品重量。
- post_fee:郵費。
- express_fee:快遞費。
- ems_fee:EMS 費。
- shipping_to:發貨地。
- video:商品視頻。
- sample_id:樣品 ID。
- props_name:商品屬性名稱。
- prop_imgs:屬性圖片。
- property_alias:屬性別名。
- props:商品屬性列表。
注意事項
- 調用頻率限制:接口的使用可能會受到頻率限制,在實際應用中需要注意控制請求頻率,避免觸發限制,以免影響正常使用或導致賬號被封禁等問題.
- 接口更新:由于阿里巴巴平臺可能會對接口進行更新,建議定期查看官方的 API 文檔,以獲取最新的接口信息,確保接口的正確使用.
- 遵守規定:在使用接口時,必須遵守 1688 的服務條款和相關法律法規,不得將數據用于非法或未經授權的用途,確保數據的合法獲取和使用.