授权方式与调用限制
1 请求结构
服务地址：目前支持的域名列表为:
| 接口域名 | 域名 |
|---|---|
| 请求域名 | proxy.qg.net |
2 公共参数
公共参数是用于标识用户和接口的参数，如非必要，在每个接口单独的接口文档中不再对这些参数进行说明，但每次请求均需要携带这些参数，才能正常发起请求。
| 参数名 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| Method | 是 | String | 具体操作的指令接口名称，例如想要调用查询代理IP列表接口，则Method参数即为query。 |
| Key | 是 | String | 在 https://www.qg.net 上购买代理IP后得到的标识身份的密钥Key。 |
| Num | 否 | Integer | 数量 |
| KeepAlive | 否 | Integer | 生存周期(单位分钟) |
| AreaId | 否 | Integer | 区域编号(参考区域编号数据表) |
| detail | 否 | Integer | 是否查看详情(可查看到具体的省市县信息) |
| IP | 否 | String | 节点IP，多个用”，”分割；全部以”* “表示 |
| Isp | 否 | String | 运营商，默认随机，1:电信；2:移动；3:联通；4:BGP |
| TaskID | 否 | String | 任务ID，多个用”，”分割；全部以”* “表示 |
假设用户想要查询已申请的代理IP列表(其中Method为query)，则其请求链接的形式可能如下:
https://proxy.qg.net/query?Key=密钥
3 接口请求频率
接口频率限制时间均为一分钟内，从触发某个接口的时间开始计时的一分钟。具体详情如下：
| 接口类型 | 频率限制 |
|---|---|
| /allocate 提取IP资源 | 按时：通道数*5+10，按量：60 |
| /replace 更换IP资源 | 按时：通道数*5+10 |
| /extract 获取IP资源池 | 动态共享按时：45 |
| /release 释放IP资源 | 动态独享按时：通道数*5 |
| /query 查询IP资源 | 按时：通道数*5+10 |
| /whitelist/add 添加白名单 | 20 |
| /whitelist/del 删除白名单 | 20 |
| /whitelist/query 查询白名单 | 60 |
| /info/quota 通道配额 | 60 |
| /resources 区域查询 | 60 |
4 释放次数限制
| 套餐类型 | 释放次数限制说明 |
|---|---|
| 动态独享 | 每分钟的释放限制次数为通道数*2 |
| 动态共享 | 不能自主释放，套餐时长到期后自动释放 |
| 静态独享 | 超过一天后能释放，一周不超过2次 |
| 动态独占 | 添加的资源要12小时后才能更换 |
5 通信协议
青果云代理IP-API的所有接口均支持HTTP、HTTPS进行通信，提供高安全性的通信通道。
6 请求方法
同时支持 POST 和 GET 请求，需要注意不能混合使用。即如果使用 GET 方式，则参数均从 Querystring 取得；如果使用 POST 方式，则参数均从 Request Body 中取得，Querystring 中的参数将忽略。两种方式参数格式规则相同，一般使用GET，当参数字符串过长时使用POST，请见各接口详细描述。
7 字符编码
均使用UTF-8编码。
