取消
最近搜索
清空历史

私密代理开发手册

总览

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

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

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

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

API接口

私密代理API接口一览

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

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

测试代理可用性

私密代理支持白名单和用户名密码两种验证方式,建议您先在本机测试,测试OK后就可以正常使用了。

查看测试步骤

带宽和频率限制

程序请求单个私密代理IP的峰值带宽默认为2Mb/s,带宽占用超限后的请求将收到440错误(参见下表)。

错误码一览

HTTP返回码 Response body 内容 说明
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 认证方式检测失败
443 Foreign Client Forbidden 禁止海外客户端
444 Download Not Allowed 禁止下载文件
445 illegal Request Forbidden 非法的请求
446 Host DNS Failed DNS解析错误
447 Real-name Authentication Required 需要实名认证
448 Target Port Forbidden 禁止访问目标端口
449 Foreign Host Forbidden 禁止访问境外网址
450 IP As Host Forbidden 禁止通过IP访问
451 Miss Host 代理请求格式不正确
452 Public Host Required 目标地址不是公网IP
453 Proxy Port Error 使用了错误的端口号
454 Proxy Authentication Expired 代理验证过期
460 Proxy Authentication Invalid 没有提取过此代理ip
503 Proxy Connect Error 连接目标网站失败

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
    周一至周五 09:00~21:00,周六09:00~18:30
  • 提交工单
    您的每一次反馈我们都认真对待
  • 客服企业微信 & QQ
    企微:点击此处 或扫码 QQ:800849628
  • 商务合作通道
    如需商务合作请通过专用通道联系我们