1.请求结构:
服务地址:疾行代理ip目前支持的域名列表为:接口域名域名请求域名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,疾行代理ip多个以逗号“,”分割,全部以”* “表示Isp否String运营商,多个以逗号“,”分割,默认随机 1:电信,2:移动,3:联通,4:BGPTaskID否String任务ID,多个以逗号“,”分割,全部以”* “表示假设用户想要查询已申请的代理IP列表(其中Method为query),则其请求链接的形式可能如下:?Key=密钥
3.接口请求频率接口频率限制时间均为一分钟内,从触发某个接口的时间开始计时的一分钟。具体详情如下:
接口类型频率限制/allocate 申请通道数*5+10/release 释放通道数*5/query 查询通道数*5+10/whitelist/add 添加白名单20/whitelist/del 删除白名单20/whitelist/query 查询白名单60/info/quota 通道配额查询60/resources 资源查询604.释放次数限制
套餐类型释放次数限制说明动疾行代理ip态独享每分钟的释放限制次数为通道数*2动态共享不能自主释放,套餐时长到期后自动释放静态独享超过一天后能释放,一周不超过2次动态独占添加的资源要12小时后才能更换5.通信协议
青果云代理IP-API的所有接口均支持HTTP、HTTPS进行通信,提供高安全性的通信通道。
6.请求方法
同时支持 POST 和 GET 请求,需要注意不能混合使用。即如果使用 GET 方式,则参数均从 Querystring 取得;如果使用 POST 方式,则参数均从 Request Body 中取得,Querystring 中的参数将忽略。两种方式参数格式规则相同,一般使用GET,当参数字符串过长时使用POST,请见各接口详细描述。
7.字符编码
均使用UTF-8编码。