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