取消
最近搜索
清空历史

私密代理开发手册

总览

新手开发者可通过如下3个步骤使用私密代理:

一、先在网页上提取私密代理,进行本地调试和验证

二、 参考代码样例请求私密代理。

三、 在程序中通过调用API接口获取代理,然后请求目标网站。

API接口

私密代理API接口一览

接口名称 接口功能
GetDps 获取私密代理IP
CheckDpsValid 检测私密代理有效性
GetDpsValidTime 获取私密代理的可用时长
GetIpBalance 获取订单IP提取余额
GetIpWhitelist 获取私密代理IP白名单
SetIpWhitelist 设置私密代理IP白名单
AddWhiteIP 添加白名单IP
DelWhiteIP 删除白名单IP
GetProxyAuthorization 获取私密代理鉴权信息

在线提取私密代理
在线生成API链接

测试代理可用性

私密代理支持白名单和用户名密码两种验证方式,建议您先在本机测试,测试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使用统计

开发建议

参考如下开发建议,可以帮助您更加顺利地完成开发和调试:

  1. 关注代理服务器的返回码可协助您排查错误。
  2. 关注IP使用统计了解程序的请求量和出错情况的统计分析,不断优化。
  3. 提取IP后尽快使用,不要在IP池里放太久,可随时调用API接口获取IP的剩余可用时长,淘汰掉不可用的IP。
  4. 控制好请求频率,用同一IP请求同一网站建议不超过1秒1次,避免IP被目标网站屏蔽。
  5. 使用用户名密码访问请不要设置IP白名单,因为IP白名单和用户名密码共用白名单IP额度。
  6. 尽可能采用gzip压缩加速访问,在header里添加:Accept-Encoding: gzip

使用gzip详解

使用gzip压缩传输数据可显著提升访问速度,方法非常简单:
只需在http请求的header里加上:
Accept-Encoding: gzip
收到HTTP Response后检查header里是否包含:
Content-Encoding: gzip
如果包含,则对body进行gzip解压,就能得到原始内容。

代码样例

调用API
请求私密代理 (Http)
请求私密代理 (Socks)

SDK下载

SDK下载

联系我们
  • 售前在线咨询
    咨询享免费测试,专业工程师提供技术支持
  • 客服热线
    400-058-0638  周一至周六 9:00-21:00
  • 提交工单
    您的每一次反馈我们都认真对待
  • 客服企业微信 & QQ
    企微:请微信扫码 客服QQ:800849628
  • 商务合作通道
    如需商务合作请通过专用通道联系我们