海外代理开发手册
总览
新手开发者可通过如下2个步骤使用海外代理：
一、购买成功后，先在会员中心查看海外信息，进行本地调试和验证。
二、海外代理代码使用方式和隧道代理一致，请参考隧道代码样例请求海外代理访问目标网站。
ip地区、换ip周期设置
管理台设置
您可以在会员中心-海外代理订单管理里查看和修改当前的地区、周期配置，修改成功后一分钟内生效。
编码设置
以使用美国-纽约地区ip、换ip周期1分钟为例。
您可以在程序中通过如下两种方式设置：
方式一：通过用户名密码设置地区、周期
以这样的格式{username}-region-{US}-area-{New York}-period-{1}:{password}，将用户名、国家编码、地区编码、换ip周期(分钟)、密码填入后base64编码生成Proxy-Authorization。
例如用户名为f2964279696，密码为jkr369ry，本次请求使用美国-纽约地区ip、换ip周期1分钟。以Python为例，用如下代码段生成base64验证串：
import base64
print base64.b64encode('f2964279696-region-US-area-New York-period-1:jkr369ry')
另外您也可以配置多个用户名密码，指定不同的地区、周期，根据业务不同灵活使用。
base64.b64encode('f2964279696-region-JP-area-Tokyo-period-0:jkr369ry') # 日本东京地区、每次请求换ipbase64.b64encode('f2964279696-region-GB-period-1:jkr369ry') # 英国地区、1分钟换ip
方式二：通过Header设置地区、周期（只支持http）
以本次请求使用美国-纽约地区ip、换ip周期1分钟为例，在发起http请求时携带如下Header（Header不区分大小写）：
Kdl-Region: US
Kdl-Area: New York
Kdl-Period: 1
同样的您也可以配置多个header，指定不同的地区、周期，根据业务不同灵活使用。（使用提示：方式一的优先级高于方式二）
国家编码、地区名称可以通过快代理提供的api获取，GetFpsCountryCode 获取国家编码、GetFpsAreaCode 获取地区编码。
- 当您通过编码方式设置地区、周期，系统会忽略您在会员中心-海外代理订单管理里的地区、周期配置。
- 如果您目标网站所在的国家属于亚洲，建议您在
新加坡(或附近)租用请求源服务器，并且使用亚洲代理域名as.xxx.kdlfps.com，这样可以达到最低延迟；如果您目标网站所在的国家属于美国或者非亚洲国家，建议您在圣佛兰西斯科(或附近)租用请求源服务器，并且使用美洲代理域名us.xxx.kdlfps.com,这样可以达到最低延迟
API接口
海外代理API接口一览
| 接口名称 | 接口功能 |
|---|---|
| GetFps | 获取海外代理IP |
| GetFpsCountryCode | 获取海外代理国家编码 |
| GetFpsAreaCode | 获取海外地区（省/州）编码 |
| GetIpWhitelist | 获取IP白名单 |
| SetIpWhitelist | 设置IP白名单 |
| AddWhiteIP | 添加白名单IP |
| DelWhiteIP | 删除白名单IP |
| GetProxyAuthorization | 获取鉴权信息 |
测试海外代理可用性
海外代理支持白名单和用户名密码两种验证方式，建议您先在本机测试，测试OK后就可以正常使用了。
关于IP白名单数量
如果您选择设置白名单访问海外，最多可设置200个白名单IP。
只要请求不超过购买时选择的每秒并发数，通过用户名密码访问海外的IP数量没有限制。
错误码一览
| HTTP返回码 | 说明 |
|---|---|
| 407 | 情况一：用户名密码验证失败 情况二：白名单验证失败 |
| 440 | 带宽超限 |
| 441 | HTTP请求/TCP连接超频 |
| 442 | 认证方式检测失败 |
| 446 | DNS解析错误 |
| 447 | 需要实名认证 |
| 451 | 代理请求格式不正确 |
| 452 | 目标地址不是公网IP |
| 453 | 使用了错误的端口号 |
| 456 | 非网络环境（含港澳台） |
| 459 | 剩余流量不足 |
| 503 | 连接目标网站失败 |
海外代理使用统计
隧道模式统计功能提供了对请求量和请求错误的统计分析。
您可以随时关注采集程序的运行走势，了解发生的错误并及时修正。我们还为几种常见的错误提供了分析和提示，帮助您提升采集程序运行的成功率。
流量统计方便您跟踪流量的使用详情。通过流量统计折线图，您可以更好地把控带宽使用情况。
开发建议
参考如下开发建议，可以帮助您更加顺利地完成开发和调试：
- 控制好请求频率，用同一IP请求同一网站建议不超过1秒1次，避免IP被目标网站屏蔽。
- 建议关闭HTTP协议的keep-alive功能，避免因连接复用导致海外不能切换IP
- 尽可能采用gzip压缩加速访问，在header里添加：Accept-Encoding: gzip
- 关注海外代理返回码可协助您排查错误。
使用gzip详解
使用gzip压缩传输数据可显著提升访问速度，方法非常简单：
只需在http请求的header里加上：
Accept-Encoding: gzip
收到HTTP Response后检查header里是否包含：
Content-Encoding: gzip
如果包含，则对body进行gzip解压，就能得到原始内容。
代码样例
海外代理代码使用方式和隧道代理一致，请参考隧道代码样例