海外代理静态住宅开发手册
总览
新手开发者可通过如下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 | 请求 / 连接超频 |
| 442 | Authentication Type Error | 认证方式检测失败 |
| 446 | Host DNS Failed | DNS解析错误 |
| 447 | Real-name Authentication Required | 需要实名认证 |
| 451 | Miss Host | 请求格式不正确 |
| 452 | Public Host Required | 内网地址 |
| 453 | Proxy Port Error | 代理端口号错误 |
| 456 | CN Client Forbidden | 中国⼤陆客户端被禁⽌访问 |
| 461 | Unauthorized IP Usage | 无权使用此IP |
| 466 | Real-name Verify Required | 实名核验 |
| 515 | Target Unavailable | 连接目标地址网络异常 |
| 516 | Proxy Failed | 获取上级代理失败 |
| 517 | Proxy Setup Failed | 设置上级代理失败 |
开发建议
参考如下开发建议，可以帮助您更加顺利地完成开发和调试：
- 尽可能采用gzip压缩加速访问，在header里添加：Accept-Encoding: gzip
- 控制好请求频率，用同一IP请求同一网站建议不超过1秒1次，避免IP被目标网站屏蔽。
- 使用用户名密码访问请不要设置IP白名单，因为IP白名单和用户名密码共用白名单IP额度。
- 关注IP使用统计了解程序的请求量和出错情况的统计分析，不断优化。
- 关注代理服务器的返回码可协助您排查错误。
使用gzip详解
使用gzip压缩传输数据可显著提升访问速度，方法非常简单：
只需在http请求的header里加上：
Accept-Encoding: gzip
收到HTTP Response后检查header里是否包含：
Content-Encoding: gzip
如果包含，则对body进行gzip解压，就能得到原始内容。