私密代理开发手册
总览
新手开发者可通过如下3个步骤使用私密代理:
二、 参考代码样例请求私密代理。
三、 在程序中通过调用API接口获取代理,然后请求目标网站。
API接口
私密代理API接口一览
接口名称 | 接口功能 |
---|---|
GetDps | 获取私密代理IP |
CheckDpsValid | 检测私密代理有效性 |
GetDpsValidTime | 获取私密代理的可用时长 |
GetIpBalance | 获取订单IP提取余额 |
GetIpWhitelist | 获取私密代理IP白名单 |
SetIpWhitelist | 设置私密代理IP白名单 |
AddWhiteIP | 添加白名单IP |
DelWhiteIP | 删除白名单IP |
GetProxyAuthorization | 获取私密代理鉴权信息 |
测试代理可用性
私密代理支持白名单和用户名密码两种验证方式,建议您先在本机测试,测试OK后就可以正常使用了。
频率限制
程序请求私密代理服务器的建议频率是1个IP不超过1秒5次。
请求超过建议频率可能收到429
错误。
注意控制请求频率,持续过快请求,您的IP可能被临时屏蔽。
如果您需要更高的请求频率请联系客服定制。
错误码一览
HTTP返回码 | Response body内容 | 说明 |
---|---|---|
407 | 情况一:White IP Failed: $client_ip 情况二:Proxy Authentication Failed: $auth |
情况一:没有通过IP白名单验证 情况二:用户名密码错误,验证失败 |
429 | 情况一:Frequency Over Limit 情况二:Domain Frequency Over Limit 情况三:Connection Over Max |
情况一:请求频率超过限制 情况二:风险域名请求过于频繁 情况三:请求频繁超过最大连接数 |
440 | Over White IP Count(client ip: $client_ip) | 用户名密码验证通过,但IP超出最大数量限制 |
441 | Binary Post Forbidden | 2小时内向超过10个网站post二进制数据会返回这个错误 |
443 | IP Forbidden | 客户端IP被临时屏蔽 |
444 | Download Forbidden | 禁止下载此文件 |
445 | Access Forbidden | 禁止访问该网站 |
447 | Real Name Verify Required | 账户需要实名认证 |
449 | Foreign Access Forbidden | 禁止访问境外域名 |
502 | 情况一:Proxy Exception 情况二:Proxy Unexpect Error 情况三:Proxy Bad Server |
情况一:代理服务器异常 情况二:DNS解析错误 情况三:连接目标服务器异常 |
IP使用统计
IP使用统计功能提供了对请求量和请求错误的统计分析。
您可以随时关注采集程序的运行走势,了解发生的错误并及时修正。我们还为几种常见的错误提供了分析和提示,帮助您提升采集程序运行的成功率。
开发建议
参考如下开发建议,可以帮助您更加顺利地完成开发和调试:
- 关注代理服务器的返回码可协助您排查错误。
- 关注IP使用统计了解程序的请求量和出错情况的统计分析,不断优化。
- 提取IP后尽快使用,不要在IP池里放太久,可随时调用API接口获取IP的剩余可用时长,淘汰掉不可用的IP。
- 控制好请求频率,用同一IP请求同一网站建议不超过1秒1次,避免IP被目标网站屏蔽。
- 使用用户名密码访问请不要设置IP白名单,因为IP白名单和用户名密码共用白名单IP额度。
- 尽可能采用gzip压缩加速访问,在header里添加:Accept-Encoding: gzip
使用gzip详解
使用gzip压缩传输数据可显著提升访问速度,方法非常简单:
只需在http请求的header里加上:
Accept-Encoding: gzip
收到HTTP Response后检查header里是否包含:
Content-Encoding: gzip
如果包含,则对body进行gzip解压,就能得到原始内容。
代码样例
调用API
请求私密代理 (Http)
请求私密代理 (Socks)