取消
最近搜索
清空历史

海外代理静态住宅开发手册

总览

新手开发者可通过如下3个步骤使用海外代理静态住宅:

一、先在会员中心上查看购买的海外代理静态住宅,进行本地调试和验证

二、 参考代码样例请求海外代理静态住宅。

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

API接口

海外代理静态住宅API接口一览

接口名称 接口功能
GetSfps 获取订单下所有海外代理静态住宅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 认证方式检测失败
446 Host DNS Failed DNS解析错误
447 Real-name Authentication Required 需要实名认证
451 Miss Host 代理请求格式不正确
452 Public Host Required 目标地址不是公网IP
453 Proxy Port Error 使用了错误的端口号
456 CN Client Forbidden 中国大陆客户端禁止
503 Proxy Connect Error 连接目标网站失败
461 Unauthorized IP Usage 无权限使用此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)

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