獲取商品詳情資訊API介面:1688開放平臺功能解析
隨著網際網路技術的發展,電商平臺已經成為人們購物的主要渠道。在這個背景下,1688開放平臺提供了豐富的API介面,幫助開發者更好地與平臺互動,獲取所需資料。本文將重點關注如何獲取商品詳情資訊的API介面。
一、介面概述
透過1688開放平臺的商品詳情資訊API介面,開發者可以獲取商品的詳細資訊,包括商品名稱、價格、庫存、描述、引數等。這對於電商應用、比價工具、資料分析等方面具有很大價值。使用該介面需要向平臺申請許可權,並遵循相應的呼叫規則。
二、請求引數
在呼叫商品詳情資訊API介面時,需要傳入相應的請求引數。通常包括商品ID、呼叫時間戳、金鑰等。確保傳入的引數準確無誤,以保證介面的正常執行。
1.公共引數
名稱
|
型別
|
必須
|
描述
|
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版本
|
2.請求引數
請求引數:num_iid=610947572360
引數說明:num_iid:1688商品ID
sales_data:&sales_data=1 獲取近30天成交資料
agent:&agent=1 獲取1688分銷代發價格資料
三、響應資料
當請求成功後,API介面會返回相應的響應資料。這些資料通常包括商品的詳細資訊,如商品名稱、價格、庫存、描述、引數等。開發者可以根據實際需求,解析並處理這些資料,以實現相應的功能。
Version: Date:
名稱
|
型別
|
必須
|
示例值
|
描述
|
item |
item[]
|
0
|
|
寶貝詳情資料
|
num_iid |
String
|
0
|
|
寶貝ID
|
title |
String
|
0
|
|
商品標題
|
desc_short |
String
|
0
|
|
商品簡介
|
price |
Float
|
0
|
|
價格
|
total_price |
Float
|
0
|
|
|
suggestive_price |
Float
|
0
|
|
|
orginal_price |
Float
|
0
|
|
原價
|
nick |
String
|
0
|
|
賣家暱稱
|
num |
Int
|
0
|
|
|
detail_url |
String
|
0
|
|
寶貝連結
|
pic_url |
String
|
0
|
|
寶貝圖片
|
brand |
String
|
0
|
|
品牌
|
brandId |
Int
|
0
|
|
品牌id
|
rootCatId |
Int
|
0
|
|
頂 級分類ID
|
cid |
Int
|
0
|
|
|
desc |
String
|
0
|
|
|
item_imgs |
Mix
|
0
|
|
商品圖片
|
item_weight |
String
|
0
|
|
|
post_fee |
Float
|
0
|
|
郵費
|
express_fee |
Float
|
0
|
|
EMS費用
|
ems_fee |
Float
|
0
|
|
物流費用
|
shipping_to |
String
|
0
|
|
發貨至
|
video |
video[]
|
0
|
|
商品影片
|
sample_id |
String
|
0
|
|
|
props_name |
String
|
0
|
|
商品屬性名
|
prop_imgs |
prop_imgs[]
|
0
|
|
商品屬性圖片列表
|
property_alias |
String
|
0
|
|
屬性別名
|
props |
Mix
|
0
|
|
商品詳情
|
total_sold |
Int
|
0
|
|
|
scale |
Int
|
0
|
|
|
sellUnit |
Int
|
0
|
|
|
skus |
skus[]
|
0
|
|
商品規格資訊列表
|
seller_id |
Int
|
0
|
|
賣家ID
|
sales |
Int
|
0
|
|
銷售額
|
shop_id |
Int
|
0
|
|
店鋪ID
|
props_list |
Mix
|
0
|
|
商品屬性
|
seller_info |
seller_info[]
|
0
|
|
賣家資訊
|
tmall |
Boolean
|
0
|
|
是否天貓
|
data_from |
String
|
0
|
|
錯誤資訊
|
error |
String
|
0
|
|
錯誤資訊
|
unit |
String
|
0
|
|
單位
|
is_support_mix |
Boolean
|
0
|
|
|
mix_amount |
Int
|
0
|
|
|
mix_Begin |
Int
|
0
|
|
|
mix_number |
Int
|
0
|
|
|
sales_data |
Date
|
0
|
|
|
location |
String
|
0
|
|
發貨地
|
props_img |
Mix
|
0
|
|
屬性圖片
|
sales_info |
Mix
|
0
|
|
|
desc_img |
Mix
|
0
|
|
詳情圖片列表
|
shop_item |
Mix
|
0
|
|
|
relate_items |
Mix
|
0
|
|
|
四、呼叫示例與程式碼解析
以下是呼叫商品詳情資訊API介面的示例程式碼:
import requests def get_product_detail(product_id, timestamp, api_key): url = f"https://api.1688.com/product/detail?productId={product_id}×tamp={timestamp}&apiKey={api_key}" response = requests.get(url) if response.status_code == 200: return response.json() else: return None
-- 請求示例 url 預設請求引數已經URL編碼處理 curl -i "https://api-gw.onebound.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360"
響應示例
{ "item": { "num_iid": "610947572360", "title": "廠家直銷小米有品Qin2 Pro智慧手機學生機老人機備用機小愛同學4G", "desc_short": "", "price": "799.00", "total_price": 0, "suggestive_price": 0, "orginal_price": "799.00", "nick": "qin多親科技", "num": "1763", "detail_url": "https://detail.1688.com/offer/610947572360.html", "pic_url": " "brand": "", "brandId": "", "rootCatId": "", "cid": "50903", "desc": "<div id=\"offer-template-0\"></div><p><span><span>深圳市多親科技有限公司(簡稱“多親科技”)成立於2014年9月是國內領先的人工智慧硬體解決方案供應商。多親科技積極推動人工智慧技術的創新研發,在人工智慧終端裝置、系統軟體的研發和生產領域,具有深厚的技術沉澱與實力。</span></span></p><p><span> </span></p><p><span> 多親產品銷售網路覆蓋全國各地乃至遠銷海外,歡迎企業定製、團購、經銷代理。</span></p><p><span> 優質的產品、過硬的技術、完善的服務、是我們合作雙贏的開篇。</span></p><p><span> <span ><strong><span >歡迎有意向者實地考察,垂詢電話:13662284449.</span></strong></span></span></p><p><span> </span></p><p><span>溫馨提示:</span></p><p><span><span><span>1、可定製--</span></span>承接各種訂單訂製!為客戶定製機身、開機畫面、預裝軟體、包裝等定製!</span><br /><span><span><span>2、質量保證--</span></span>本公司專注通訊行業10年,線下線下百花齊放,客戶復購率達30%以上。</span><br /><span><span><span>3、價格實惠--</span></span>本店是工廠直供,沒有中間商差價,一站到客,薄利多銷。</span><br /><span><span><span>4、售後服務--</span></span>本店出售的所有產品均提供1年的質保。因質量原因退換貨(非人為因素)30天內換新。</span></p><p> </p><p><span><img alt=\"undefined\" height=\"446.22866894197955\" src=\"\" width=\"790\" /><br /><img alt=\"undefined\" height=\"457.5154730327144\" src=\"\" width=\"790\" /><br /><img alt=\"undefined\" height=\"443.2365499573014\" src=\"\" width=\"790\" /><br /><img alt=\"undefined\" height=\"440.350569675723\" src=\"\" width=\"790\" /><br /></span></p><p><img alt=\"undefined\" src=\"\" /></p><p><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /></p><p><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /></p><p><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /></p><p><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><br /></p>", "item_imgs": [ { "url": " }, { "url": " }, { "url": " }, { "url": " }, { "url": " } ], "item_weight": "", "post_fee": "", "express_fee": "", "ems_fee": "", "shipping_to": "", "video": [], "sample_id": "", "props_name": "0:0:機身記憶體:64GB;1:0:顏色:鐵灰色;1:1:顏色:瓷白色", "prop_imgs": { "prop_img": [] }, "property_alias": "0:0:64GB;1:0:鐵灰色;1:1:瓷白色", "props": [ { "name": "品牌", "value": "多親" }, { "name": "型號", "value": "Qin 2 Pro" }, { "name": "手機型別", "value": "老人手機" }, { "name": "外形", "value": "直板" }, { "name": "主屏尺寸", "value": "大螢幕(5.0英寸—5.9英寸)" }, { "name": "網路制式", "value": "移動4G(TD-LTE),聯通/電信4G(FDD-LTE)" }, { "name": "作業系統", "value": "Android 9.0系統" }, { "name": "電池容量", "value": "2100" }, { "name": "攝像頭畫素", "value": "1200萬-1999萬" }, { "name": "儲存卡", "value": "支援儲存卡" }, { "name": "處理器核心", "value": "八核" }, { "name": "執行記憶體", "value": "2GB" }, { "name": "手機版本", "value": "大陸行貨" }, { "name": "售後型別", "value": "全國聯保" }, { "name": "上市時間", "value": "2019" }, { "name": "適用送禮場合", "value": "員工福利,頒獎紀念,廣告促銷,節日,展銷會,公關策劃,生日,商務饋贈" }, { "name": "3C證書編號", "value": "2019161606319519" }, { "name": "CPU品牌", "value": "展訊" }, { "name": "運營商", "value": "中國移動,中國電信,中國聯通" }, { "name": "網路模式", "value": "單卡單模" }, { "name": "機身記憶體", "value": "64GB" }, { "name": "顏色", "value": "鐵灰色,瓷白色" }, { "name": "電信裝置進網許可證編號", "value": "02-B613-192425" } ], "total_sold": "1", "scale": "", "sellUnit": "", "skus": { "sku": [ { "price": "799.00", "total_price": 0, "sales": "55", "properties": "0:0;1:1", "properties_name": "0:0:機身記憶體:64GB;1:1:顏色:瓷白色", "quantity": "932", "sku_id": "4309097072612", "spec_id": "63828b15ad641fdb131775f32e4c050c" }, { "price": "799.00", "total_price": 0, "sales": "159", "properties": "0:0;1:0", "properties_name": "0:0:機身記憶體:64GB;1:0:顏色:鐵灰色", "quantity": "831", "sku_id": "4302217872901", "spec_id": "0eb631954bfe8fb00a45824fc6193f2f" } ] }, "seller_id": "2206619673102", "sales": 30, "shop_id": "", "props_list": { "0:0": "機身記憶體:64GB", "1:0": "顏色:鐵灰色", "1:1": "顏色:瓷白色" }, "seller_info": { "nick": "qin多親科技", "user_num_id": "2206619673102", "sid": "b2b-2206619673102e9470", "title": "深圳多親科技實力賣場", "zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-2206619673102e9470", "shop_name": "qin多親科技" }, "tmall": "", "data_from": "1688app", "error": "", "unit": "部", "is_support_mix": null, "mix_amount": null, "mix_begin": null, "mix_number": null, "min_num": "2", "sales_data": "", "location": "廣東省 深圳市", "props_img": [], "sales_info": { "seller_num": "", "repeat_rate_purchase": "", "per_capita_purchases": "", "comment_num": "", "comment_url": "" }, "desc_img": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "shop_item": [], "relate_items": [] }, "secache": "f75c59301daa3fc1610a8563c998f851", "secache_time": 1608276252, "secache_date": "2020-12-18 15:24:12", "translate_status": "", "translate_time": 0, "language": { "default_lang": "cn", "current_lang": "cn" }, "error": "", "reason": "", "error_code": "0000", "cache": 0, "api_info": "today:12 max:10000", "execution_time": 6.65, "server_time": "Beijing/2020-12-18 15:24:17", "client_ip": "182.111.155.89", "call_args": { "num_iid": "610947572360", "area_id": "440111" }, "api_type": "1688", "translate_language": "zh-CN", "translate_engine": "google_cn", "server_memory": "4.44MB", "request_id": "gw-2.5fdc591b3bdb0" }
異常示例
{ "error": "item-not-found", "reason": "商品沒找到", "error_code": "2000", "success": 0, "cache": 0, "api_info": "today:0 max:10000", "execution_time": 0.081, "server_time": "Beijing/2020-06-10 23:44:00", "call_args": [], "api_type": "1688", "request_id": "15ee0ffc041242" }
錯誤碼解釋
狀態程式碼(error_code)
|
狀態資訊
|
詳細描述
|
是否收費
|
0000
|
success
|
介面呼叫成功並返回相關資料
|
是
|
2000
|
Search success but no result
|
介面訪問成功,但是搜尋沒有結果
|
是
|
4000
|
Server internal error
|
伺服器內部錯誤
|
否
|
4001
|
Network error
|
網路錯誤
|
否
|
4002
|
Target server error
|
目標伺服器錯誤
|
否
|
4003
|
Param error
|
使用者輸入引數錯誤
|
忽略
|
4004
|
Account not found
|
使用者帳號不存在
|
忽略
|
4005
|
Invalid authentication credentials
|
授權失敗
|
忽略
|
4006
|
API stopped
|
您的當前API已停用
|
忽略
|
4007
|
Account stopped
|
您的賬戶已停用
|
忽略
|
4008
|
API rate limit exceeded
|
併發已達上限
|
忽略
|
4009
|
API maintenance
|
API維護中
|
忽略
|
4010
|
API not found with these values
|
API不存在
|
忽略
|
4012
|
Please add api first
|
請先新增api
|
忽略
|
4013
|
Number of calls exceeded
|
呼叫次數超限
|
忽略
|
4014
|
Missing url param
|
引數缺失
|
忽略
|
4015
|
Wrong pageToken
|
引數pageToken有誤
|
忽略
|
4016
|
Insufficient balance
|
餘額不足
|
忽略
|
4017
|
timeout error
|
請求超時
|
否
|
5000
|
unknown error
|
未知錯誤
|
否
|
五、常見問題與處理方法
在呼叫商品詳情資訊API介面時,可能會遇到一些問題,如請求超時、引數錯誤等。以下是一些常見問題的處理方法:
- 請求超時:檢查網路連線是否正常,同時適當增加請求超時時間。
- 引數錯誤:仔細核對傳入的請求引數,確保與文件要求一致。特別注意商品ID、時間戳和API金鑰的準確性。
- 返回資料異常:檢查響應資料的狀態碼和內容,分析可能的原因。如有需要,可聯絡1688開放平臺技術支援尋求幫助。
六、總結與展望
透過本文的介紹,我們瞭解瞭如何使用1688開放平臺的商品詳情資訊API介面獲取商品詳細資訊。這一功能對於開發者來說具有很高的實用價值,可以幫助實現電商應用、比價工具、資料分析等多種功能。在未來的發展中,隨著電商平臺的不斷壯大和開放平臺技術的持續進步,我們期待看到更多實用、便捷的API介面出現,為開發者提供更多可能性。
來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/70026910/viewspace-2996142/,如需轉載,請註明出處,否則將追究法律責任。
相關文章
- 使用1688開放平臺API介面獲取商品詳情資訊API
- 使用商品詳情API介面獲取商品資料API
- 使用API介面獲取拼多多商品詳情API
- 獲取1688商品詳情API:步驟與程式碼示例API
- 用PHP使用API介面獲取蝦皮商品詳情PHPAPI
- 淘寶詳情API介面:一鍵獲取商品資訊的實踐探索API
- python批次採集1688商品詳情資料介面+1688商品列表資料介面+1688商品API資料介面PythonAPI
- 淘寶開放平臺API - 獲取單筆交易的詳細資訊API
- 1688商品詳情API跨境專用介面php javaAPIPHPJava
- 1688詳情api介面API
- 阿里巴巴國際站API詳情介面獲取商品詳情介面阿里API
- 詳情API介面上貨搬運獲取資訊API介面API
- Lazada詳情API介面:一鍵獲取商品資訊的深度實踐API
- 用Java使用API介面獲取Lazada商品詳情JavaAPI
- Temu api介面 獲取商品詳情 資料採集API
- 透過1688店鋪所有商品API介面一鍵獲取店鋪所有商品資訊API
- 如何使用商品詳情API介面來獲取想要的商品資料?API
- Java語言獲取小紅書商品詳情 API介面(商品ID、商品標題等)JavaAPI
- 獲取淘寶商品詳情api、介面獲取寶貝詳情、產品詳細屬性示例說明API
- C++語言亞馬遜獲取AMAZON商品詳情 API介面C++亞馬遜API
- 教您如何使用API介面獲取拼多多商品詳情API
- 商品詳情API介面API
- 1688 API分享:抓取1688商品詳情頁資料API
- 各類電商平臺批次獲取商品資訊 API 詳細操作說明API
- 速賣通API介面解析,實現獲得aliexpress商品詳情APIExpress
- 拼多多API介面解析,實現根據ID取商品詳情API
- 獲取拼多多商品詳情api、介面獲取寶貝詳情、產品詳細屬性Java示例說明APIJava
- 開放平臺API介面API
- 1688商品詳情資料介面、商品列表介面,商品屬性介面、商品優惠券介面
- 如何使用商品詳情API介面獲取商品資料:一篇詳盡的論述API
- 1688商品詳情APIERP選品專用API介面 Python JavaAPIPythonJava
- 阿里巴巴商品採集介面 商品詳情api 商品主圖介面 商品詳情圖介面阿里API
- Java獲取淘寶/天貓商品詳情 API介面(寶貝詳情資料、寶貝ID、寶貝標題、商品簡介等)JavaAPI
- 拼多多根據ID取商品詳情 API介面(item_get-根據ID取商品詳情)API
- 透過API介面獲取阿里巴巴商品詳情示例說明API阿里
- 震坤行API介面聚合解析,實現根據ID取商品詳情API
- 揭秘微店詳情API介面:引領商品資訊獲取新篇章,賦能開發者無限可能API
- 拼多多API介面:拼多多根據ID取商品詳情 APIAPI