取消
最近搜索
清空历史

独享代理开发手册

总览

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

一、先在会员中心上查看购买的独享代理,进行本地调试和验证

二、 参考代码样例请求独享代理。

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

API接口

独享代理API接口一览

接口名称 接口功能
GetKps 获取订单下所有独享代理IP
GetIpWhitelist 获取独享代理IP白名单
SetIpWhitelist 设置独享代理IP白名单
AddWhiteIP 添加白名单IP
DelWhiteIP 删除白名单IP
GetProxyAuthorization 获取独享代理鉴权信息

测试代理可用性

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

查看测试步骤

带宽和频率限制

独享代理对请求频率不设限制。
程序请求独享代理的峰值带宽以所购买的带宽规格为准,带宽占用超限后的请求将收到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 代理验证过期
503 Proxy Connect Error 连接目标网站失败

IP使用统计

IP使用统计功能提供了对请求量和请求错误的统计分析。
您可以随时关注采集程序的运行走势,了解发生的错误并及时修正。我们还为几种常见的错误提供了分析和提示,帮助您提升采集程序运行的成功率。

IP使用统计
状态统计

开发建议

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

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

使用gzip详解

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

代码样例

调用API
请求独享代理(Http)
请求独享代理(Socks)

SDK下载

SDK下载

联系我们