一、接口調(diào)用流程

認(rèn)證授權(quán)
需先通過(guò)開(kāi)放平臺(tái)申請(qǐng)App Key和App Secret，獲取access_token：

# Python示例 import requests auth_url = "https://gw.open.1688.com/auth/authorize" params = { "client_id": "YOUR_APP_KEY", "redirect_uri": "CALLBACK_URL", "site": "china" } # 獲取授權(quán)碼后交換token

請(qǐng)求構(gòu)造
核心搜索接口地址：
https://api.1688.com/param2/1/com.alibaba.product/alibaba.product.search/
必備參數(shù)：

{ "keyword": "手機(jī)", // 搜索關(guān)鍵字 "pageNo": 1, // 頁(yè)碼 "pageSize": 20, // 每頁(yè)數(shù)量 "access_token": "xxx" // 認(rèn)證令牌 }

二、響應(yīng)數(shù)據(jù)結(jié)構(gòu)解析

{ "result": { "totalCount": 1500, "products": [ { "productId": 123456789, "subject": "華為Mate60 Pro 5G手機(jī)", "price": "￥5999", "imageUrl": "https://img.alicdn.com/xxx.jpg", "minOrder": 1, "unit": "臺(tái)" } ], "pageIndex": 1, "pageSize": 20, "totalPage": 75 } }

三、簽名安全機(jī)制

需使用HMAC-SHA1簽名算法：

// PHP簽名示例 $params = ksort($params); // 參數(shù)按鍵名排序 $stringToSign = strtoupper('GET') . '&' . urlencode('/api/endpoint') . '&'; foreach ($params as $k => $v) { $stringToSign .= urlencode("$k=$v") . '&'; } $sign = base64_encode(hash_hmac('sha1', $stringToSign, $appSecret, true));

四、分頁(yè)處理技巧

通過(guò)totalPage字段計(jì)算總頁(yè)數(shù)： $$ text{總頁(yè)數(shù)} = lceil frac{text{totalCount}}{text{pageSize}} rceil $$

推薦增量爬?。?/p>

current_page = 1 while current_page <= response['totalPage']: # 延時(shí)避免限流 time.sleep(1.5) current_page += 1

五、注意事項(xiàng)

頻率限制：免費(fèi)版限速200次/分鐘，企業(yè)版可申請(qǐng)?zhí)嵘?00次/分鐘

數(shù)據(jù)新鮮度：接口數(shù)據(jù)延遲約15-30分鐘

錯(cuò)誤碼處理：

10000：簽名無(wú)效

10001：參數(shù)缺失

20000：頻次超限

完整文檔參考：1688開(kāi)放平臺(tái)搜索API文檔
建議使用官方SDK簡(jiǎn)化開(kāi)發(fā)流程，支持Java/Python/PHP等多語(yǔ)言集成。

審核編輯 黃宇