獨享代理開發(fā)手冊
總覽
新手開發(fā)者可通過如下3個步驟使用獨享代理：
一、先在會員中心上查看購買的獨享代理，進行本地調(diào)試和驗證。
二、 參考代碼樣例請求獨享代理。
三、 在程序中通過調(diào)用API接口獲取代理，然后請求目標(biāo)網(wǎng)站。
API接口
獨享代理API接口一覽
| 接口名稱 | 接口功能 |
|---|---|
| GetKps | 獲取訂單下所有獨享代理IP |
| GetIpWhitelist | 獲取獨享代理IP白名單 |
| SetIpWhitelist | 設(shè)置獨享代理IP白名單 |
| AddWhiteIP | 添加白名單IP |
| DelWhiteIP | 刪除白名單IP |
| GetProxyAuthorization | 獲取獨享代理鑒權(quán)信息 |
測試代理可用性
獨享代理支持白名單和用戶名密碼兩種驗證方式，建議您先在本機測試，測試OK后就可以正常使用了。
帶寬和頻率限制
獨享代理對請求頻率不設(shè)限制。
程序請求獨享代理的峰值帶寬以所購買的帶寬規(guī)格為準(zhǔn)，帶寬占用超限后的請求將收到440錯誤（參見下表）。
錯誤碼一覽
| HTTP返回碼 | Response body 內(nèi)容 | 說明 |
|---|---|---|
| 407 | 情況一：Proxy Authentication Failed:%auth 情況二：White IP Failed:$client_ip |
情況一：用戶名密碼驗證失敗 情況二：白名單驗證失敗 |
| 440 | Bandwidth Over Limit | 帶寬超限 |
| 441 | Request Rate Over Limit | HTTP請求/TCP連接超頻 |
| 442 | Authentication Type Error | 認(rèn)證方式檢測失敗 |
| 443 | Foreign Client Forbidden | 禁止海外客戶端 |
| 444 | Download Not Allowed | 禁止下載文件 |
| 445 | illegal Request Forbidden | 非法的請求 |
| 446 | Host DNS Failed | DNS解析錯誤 |
| 447 | Real-name Authentication Required | 需要實名認(rèn)證 |
| 448 | Target Port Forbidden | 禁止訪問目標(biāo)端口 |
| 449 | Foreign Host Forbidden | 禁止訪問境外網(wǎng)址 |
| 450 | IP As Host Forbidden | 禁止通過IP訪問 |
| 451 | Miss Host | 代理請求格式不正確 |
| 452 | Public Host Required | 目標(biāo)地址不是公網(wǎng)IP |
| 453 | Proxy Port Error | 使用了錯誤的端口號 |
| 454 | Proxy Authentication Expired | 代理驗證過期 |
| 503 | Proxy Connect Error | 連接目標(biāo)網(wǎng)站失敗 |
IP使用統(tǒng)計
IP使用統(tǒng)計功能提供了對請求量和請求錯誤的統(tǒng)計分析。
您可以隨時關(guān)注采集程序的運行走勢，了解發(fā)生的錯誤并及時修正。我們還為幾種常見的錯誤提供了分析和提示，幫助您提升采集程序運行的成功率。
開發(fā)建議
參考如下開發(fā)建議，可以幫助您更加順利地完成開發(fā)和調(diào)試：
- 盡可能采用gzip壓縮加速訪問，在header里添加：Accept-Encoding: gzip
- 控制好請求頻率，用同一IP請求同一網(wǎng)站建議不超過1秒1次，避免IP被目標(biāo)網(wǎng)站屏蔽。
- 使用用戶名密碼訪問請不要設(shè)置IP白名單，因為IP白名單和用戶名密碼共用白名單IP額度。
- 關(guān)注IP使用統(tǒng)計了解程序的請求量和出錯情況的統(tǒng)計分析，不斷優(yōu)化。
- 關(guān)注代理服務(wù)器的返回碼可協(xié)助您排查錯誤。
使用gzip詳解
使用gzip壓縮傳輸數(shù)據(jù)可顯著提升訪問速度，方法非常簡單：
只需在http請求的header里加上：
Accept-Encoding: gzip
收到HTTP Response后檢查header里是否包含：
Content-Encoding: gzip
如果包含，則對body進行gzip解壓，就能得到原始內(nèi)容。
代碼樣例
調(diào)用API
請求獨享代理（Http）
請求獨享代理（Socks）