1.接口描述

接口地址：https://www.fwvps.com/query

本接口用于查询用户可用的代理IP资源列表。

该接口单个Key的请求频率限制为：（通道数*5+10）次/分钟；

方法：HTTP、GET，需要注意不能混合使用；

编码：参数和返回内容均采用utf-8编码。

2.输入参数说明

3.返回值

接口可返回json格式，字段说明如下：

4.示例

请求接口示例：

1. https://www.fwvps.comt/query?Key=请改成您的Key

返回示例：

 {
    "Code ":0,
    "TotalNum":5,
    "TaskNum":5,
    "TaskList ": [
        {
           "IP ": "127.0.0.1",
          "port ": "49168",
          "deadline  ": "2018-05-11 02:56:02",
          "host  ": "127.0.0.1:49168",
        }
    ]
}

5.错误码

1.请求结构：

服务地址：目前支持的域名列表为:

2.公共参数

公共参数是用于标识用户和接口的参数，如非必要，在每个接口单独的接口文档中不再对这些参数进行说明，但每次请求均需要携带这些参数，才能正常发起请求。

假设用户想要查询已申请的代理IP列表(其中Method为query)，则其请求链接的形式可能如下:
https://www.fwvps.comquery?Key=密钥

3.接口请求频率
接口频率限制时间均为一分钟内，从触发某个接口的时间开始计时的一分钟。具体详情如下：

4.释放次数限制

5.通信协议

青果云代理IP-API的所有接口均支持HTTP、HTTPS进行通信，提供高安全性的通信通道。

6.请求方法

同时支持 POST 和 GET 请求，需要注意不能混合使用。即如果使用 GET 方式，则参数均从 Querystring 取得；如果使用 POST 方式，则参数均从 Request Body 中取得，Querystring 中的参数将忽略。两种方式参数格式规则相同，一般使用GET，当参数字符串过长时使用POST，请见各接口详细描述。

7.字符编码

均使用UTF-8编码。

1.接口描述

接口地址：https://www.fwvps.com/extract

本接口用于获取IP资源池全部可用的IP信息，该接口仅按时动态共享业务可用。

该接口单个Key的请求频率限制为60次/分钟；

需要注意的是请求方方式只能用GET；

编码：参数和返回内容均采用utf-8编码。

2.输入参数说明

3.返回值

接口可返回文本格式、json格式、xml格式，字段说明如下：

4 示例

请求接口示例：

1. https://www.fwvps.comt/extract?Key=请改成您的Key

返回示例：

{
  "Code": 0,
  "Data": [
    {
      "IP": "175.43.188.196",
      "port": "64450",
      "deadline": "2021-11-20 11:32:20",
      "host": "175.43.188.196:64450",
      "region": "福建省泉州市晋江市联通"
    },
    {
      "IP": "114.238.148.203",
      "port": "50938",
      "deadline": "2021-11-20 11:32:20",
      "host": "114.238.148.203:50938",
      "region": "江苏省淮安市电信"
    },
    {
      "IP": "117.92.121.222",
      "port": "11136",
      "deadline": "2021-11-20 11:32:20",
      "host": "117.92.121.222:11136",
      "region": "江苏省连云港市电信"
    }
  ],
  "Num": 3,
  "TaskID": "mw13Wq0srzt9uLEt"
}

5.错误码

简要描述：

• 本接口用于查询可用区关联规格信息。接口请求地址

注：

• 当请求参数 line_no 和 area_no 同时存在，area_no 必须为 line_no 所属线路下的 可用区编号。

参数：

输入示例

https://www.fwvps.com/api/cloud-product/packageList?productId=104

返回示例
JSON格式

  {
    "RequestId":'423369C7-AD6F-3GT6-NMJ7-E2RG5N6HG7D3',
    "Code": 0,
    "Message" : "返回内容"
    "Data": {
            "1":{
               "Line_no":"ap-beijing",
               "Area_id": 342,
               "Area_no":"ap-beijing-1",
               "Group_name":"标准型S1",
               "Group_id":"S1",
               "Area_name":"xxx",
               "Line_name":"xxx",
               "Spec_name":"标准型S1",
               "Spec_no":"S1.SMALL2",
               "Cpu" : "1",
               "Memory": "2",
               "Systemdisk":"40",
               "Datadisk":"20",
               "Bandwidth":"1",
               "Ip":"1",
               "Defense":"0",
               "Trial_time":"",
               "Buy_status":1,
               "Status":1,
               "Upgrade_status":"",
               "Package_no": "1111",
               "Basic_price": "2079.65",
               "User_price": "2079.65",
               "Day_rate": "0.01",
               "Week_rate": "0.02",
               "Month_rate": "0.1",
               "Quarter_rate": "0.301",
               "Halfyear_rate": "0.53",
               "Year_rate": "1"
            },
           "2":{
               "Line_no":"ap-beijing",
               "Area_id": 343,
               "Area_no":"ap-beijing-1",
               "Group_name":"标准型S1",
               "Group_id":"S1",
               "Area_name":"xxx",
               "Line_name":"xxx",
               "Spec_name":"标准型S1",
               "Spec_no":"S1.MEDIUM2",
               "Cpu" : "2",
               "Memory": "2",
               "Systemdisk":"40",
               "Datadisk":"20",
               "Bandwidth":"1",
               "Ip":"1",
               "Defense":"0",
               "Trial_time":"",
               "Buy_status":1,
               "Status":1,
               "Upgrade_status":"",
               "Package_no": "2222",
               "Basic_price": "2079.65",
               "User_price": "2079.65",
               "Day_rate": "0.01",
               "Week_rate": "0.02",
               "Month_rate": "0.1",
               "Quarter_rate": "0.301",
               "Halfyear_rate": "0.53",
               "Year_rate": "1"
            }
    }
  }

返回参数说明

备注

• 更多返回错误代码请看首页的错误代码描述

欢迎使用ShowDoc！欢迎使用ShowDoc！

简要描述：

• 本文档用于API公共错误码的说明：
  Code = 0: 正确返回
  Code > 0: 调用OpenAPI时发生错误，需要开发者进行相应的处理
  -50 <= Code <= -1: 接口调用不能通过接口代理机校验，需要开发者进行相应的处理
  Code <-50: 系统内部错误，请通过企业QQ联系技术支持，调查问题原因并获得解决方案

返回示例：

  {
    "RequestId": "wwwdaxxas",
    "Code": 0,
    "Message" : "返回内容"
  }

返回参数说明

公共请求参数：

• 公共参数分为 公共请求参数 和 公共返回参数

公共参数：

公共返回参数

简要描述：

API支持基于URL发起HTTP/HTTPS GET请求。请求参数需要包含在URL中。本文列举了GET请求中的结构解释，并提供了服务器的服务接入地址

通信方式：

以下为Start一条未编码的URL请求示例：
http://www.fwvps.com/api//?<公共参数>
&productId=117
&appid=*
&time=1585280982
&domain=www.fwvps.com
&sign=
https指定了请求通信协议。
qg.net指定了ECS的服务接入地址。
api类型根据API类型的不同，分为三大类，分别是operate(业务操作类,如开机，关机)，product(产品操作类，如下单，续费，升级等等)，business(产品信息类，如产品同步)
action指定了要调用的API
productId指的是产品ID
appid指的是用户在后台API信息申请的appid
time指的是用户请求API时的时间戳
domain指的是用户请求API的服务器域名
sign指的是根据appid，domain，time，以及appkey通过md5加密生成的一串秘钥
md5(appid + domain + time + appkey)

通信协议：

支持HTTP或HTTPS协议请求通信。为了获得更高的安全性，推荐您使用HTTPS协议发送请求

请求参数：

您需要通过Action参数指定目标操作，例如Action=Start。还需要指定接口的其他参数以及公共请求参数，详情请参见公共请求参数。

字符编码：

请求及返回结果都使用UTF-8字符集编码