动态代理开发指南
1. 总览¶
新手开发者可通过如下2个步骤使用动态代理：
二、 在程序中通过调用API接口获取代理，然后请求目标网站。
2. API接口¶
动态代理API接口一览
| 接口名称 | 接口功能 |
|---|---|
| dynamic/getips | 获取动态代理IP |
| dynamic/check | 检测动态代理有效性 |
| dynamic/setwhiteip | 设置动态代理IP白名单 |
| dynamic/getwhiteip | 获取动态代理IP白名单 |
| dynamic/remain | 获取动态代理的可用时长 |
| dynamic/balance | 获取动态代理订单IP提取余额 |
3. 测试代理可用性¶
动态代理支持白名单和用户名密码两种验证方式，建议您先在本机测试，测试OK后就可以正常使用了。
4. 频率限制¶
程序请求动态代理服务器的建议频率是1个IP不超过1秒5次。
请求超过建议频率可能收到429错误。
注意控制请求频率，持续过快请求，您的IP可能被临时屏蔽。
5. 错误码一览¶
| HTTP返回码 | 错误提示 | 说明 |
|---|---|---|
| 403 | Access to this website is prohibited | 网站黑名单，禁止访问。 |
| 405 | Download request not acceptable | 禁止使用代理进行下载操作。 |
| 407 | 情况一：IP is not in the whitelist 情况二：Proxy authentication verification failed |
情况一：请求IP不在白名单内，请添加白名单 情况二：用户名密码错误，请检查账号密码是否正确 |
| 412 | IP blacklist, prohibition of use | 请求IP黑名单，请更换其他IP。 |
| 421 | IP exceeds the number of white list authorizations | IP超出最大数量限制，请升级白名单数量。 |
| 429 | Too Many Requests | 请求频率超过限制，请降低请求频率。 |
| 500 | Proxy connection exception | 代理连接异常，请重连。 |
6. 开发建议¶
参考如下开发建议，可以帮助您更加顺利地完成开发和调试：
- 关注代理服务器的返回码可协助您排查错误。
- 提取IP后尽快使用，不要在IP池里放太久，可随时调用获取代理剩余可用时长接口获取IP的剩余可用时长，淘汰掉不可用的IP。
- 控制好请求频率，用同一IP请求同一网站建议不超过1秒1次，避免IP被目标网站屏蔽。
- 尽可能采用gzip压缩加速访问，在header里添加：Accept-Encoding: gzip
使用gzip详解
使用gzip压缩传输数据可显著提升访问速度，方法非常简单：
只需在http请求的header里加上：
Accept-Encoding: gzip
收到HTTP Response后检查header里是否包含：
Content-Encoding: gzip
如果包含，则对body进行gzip解压，就能得到原始内容。