服务地址:目前支持的域名列表为:
接口域名 | 域名 |
---|---|
请求域名 | proxy.qg.net |
公共参数是用于标识用户和接口的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。
参数名 | 是否必选 | 类型 | 描述 |
---|---|---|---|
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=密钥
接口频率限制时间均为一分钟内,从触发某个接口的时间开始计时的一分钟。具体详情如下:
接口类型 | 频率限制 |
---|---|
/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 |
套餐类型 | 释放次数限制说明 |
---|---|
动态独享 | 每分钟的释放限制次数为通道数*2 |
动态共享 | 不能自主释放,套餐时长到期后自动释放 |
静态独享 | 超过一天后能释放,一周不超过2次 |
动态独占 | 添加的资源要12小时后才能更换 |
青果云代理IP-API的所有接口均支持HTTP、HTTPS进行通信,提供高安全性的通信通道。
同时支持 POST 和 GET 请求,需要注意不能混合使用。即如果使用 GET 方式,则参数均从 Querystring 取得;如果使用 POST 方式,则参数均从 Request Body 中取得,Querystring 中的参数将忽略。两种方式参数格式规则相同,一般使用GET,当参数字符串过长时使用POST,请见各接口详细描述。
均使用UTF-8编码。