总览
新手开发者可通过如下3个步骤使用短效优质代理IP（纯生版）：
1、调用API接口获取代理IP，进行本地调试和验证。
2、参考代码样例请求代理IP，进行程序代码编写和调试。
3、在程序中通过调用API接口获取代理IP，然后请求目标网站。
验证代理IP可用性
短效优质代理IP（纯生版）支持"白名单"和"用户名密码"两种鉴权策略，有三种组合鉴权方式可选，建议您先在本机验证，成功后就可以正常使用了。
API接口文档说明
| 接口名称 | 接口功能 |
| GetIP | 获取代理IP |
| GetIpWhiteList | 获取IP白名单 |
| SetIpWhiteList | 设置IP白名单 |
| AddWhiteIp | 添加IP白名单 |
| DelWhiteIp | 删除IP白名单 |
| ClearWhiteIp | 清空IP白名单 |
| SetIpWhite | 自动设置IP白名单 |
带宽和频率限制
针对单个代理IP，程序请求的峰值带宽默认为1Mb/s；一旦瞬时带宽占用超出该阈值后请求将返回440状态码（具体错误定义参见下表）。
错误码说明
| HTTP返回码 | Response body 内容 | 说明 |
| 407 | Proxy Authentication Required | 场景一：用户名密码鉴权失败 场景二：白名单鉴权失败 |
| 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 | 代理身份验证过期 |
| 457 | Backend Proxy Bandwidth Over Limit | 上级代理带宽超出限制 |
| 458 | Backend Proxy Refused | 上级代理拒绝连接 |
| 464 | Invalid Param | 参数不合法 |
| 458 | Null Proxy | 没有ip资源 |
| 462 | Target Domain WhiteList Not Match | 目标域名未匹配白名单 |
| 463 | Target Domain BlackList Forbidden | 目标域名黑名单禁止 |
| 503 | Proxy Connect Error | 代理连接错误 |
开发建议
参考如下开发建议，可以帮助您更加顺利地完成开发和调试：
1、关注程序代码的返回编码，可协助您排查错误。
2、提取代理IP后尽快使用，避免代理IP过期，造成资源浪费，可调用API接口获取代理IP的剩余存活时间，随时掌握IP的情况。
3、控制好调用API接口频率，均匀提取每小时提取IP量有限，集中提取可以短时间提取完当天IP量，需要合理规划，避免影响正常使用。
4、控制好请求目标网站频率，同一IP请求同一网站建议不超过1秒1次，避免IP被目标网站屏蔽。
5、使用用户名密码访问记得带上用户名密码验证，使用终端IP授权记得绑定使用者终端IP。
6、尽量使用gzip压缩以加快访问速度并节省带宽。
| 使用gzip详解 启用 Gzip 压缩传输可显著提高访问速度，操作仅需两步： 请求配置：在 HTTP 请求头中设置 Accept-Encoding: gzip； 响应处理：若响应头携带 Content-Encoding: gzip 标识，则对响应体进行 Gzip 解压以还原原始数据。 |
代码样例
Python3使用requests调用Http代理IP的代码样例 >
Python3使用aiohttp调用Http代理IP的代码样例 >
Java使用okhttp3调用Http代理IP的代码样例 >
Node.js使用puppeteer调用Http代理IP的代码样例 >
Python3使用playwright调用Http代理IP的代码样例 >
C语言使用libcurl库调用Http代理IP的代码样例 >
Python使用Scrapy调用Http代理IP的代码样例 >
……
更多开发语言的代码样例可点击进去看左侧菜单
