1.接口描述

接口地址： https://proxy.zzqidc.com/monopolize_resources

本接口是用于请求申请独占代理IP资源。

请求频率限制：按时业务是（通道数*5＋10）次/分钟；

方法：POST；

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

2.输入参数说明

3.返回值

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

4 示例

请求接口示例：

1. curl -X POST -d 'Key=XXX&AreaCode=XX&Operator=XXX&Num=XXX' https://proxy.zzqidc.com/monopolize_resources

返回示例：

1. {
2. data: [{
3. "uuid": "fj_qzdx9-1:ppp10",
4. "area": “福建省泉州市”,
5. "area_code": 350500,
6. "operator": "电信",
7. "operator_code": 1,
8. "state": 1, //已独占、排队中
9. "wait_seconds": 35, //排队等待秒数，已独占状态秒数为0
10. "monopolize_time": "2022-02-17 14:01:05", //独占时间
11. "last_dial_time": "2022-02-17 14:01:05", //最近一次拨号时间
12. "newest_ip": "127.0.0.1:10800",
13. "redialing": 0, //是否重拨中
14. "report_ts": "2022-02-17 14:01:05",
15. },{
16. ...
17. }]
18. }

5.错误码

1.接口描述

接口地址：https://proxy.zzqidc.com/extract

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

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

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

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

2.输入参数说明

3.返回值

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

4 示例

请求接口示例：

1. https://proxy.zzqidc.com/extract?Key=请改成您的Key

返回示例：

1. {
2. "Code": 0,
3. "Data": [
4. {
5. "IP": "175.43.188.196",
6. "port": "64450",
7. "deadline": "2021-11-20 11:32:20",
8. "host": "175.43.188.196:64450",
9. "region": "福建省泉州市晋江市联通"
10. },
11. {
12. "IP": "114.238.148.203",
13. "port": "50938",
14. "deadline": "2021-11-20 11:32:20",
15. "host": "114.238.148.203:50938",
16. "region": "江苏省淮安市电信"
17. },
18. {
19. "IP": "117.92.121.222",
20. "port": "11136",
21. "deadline": "2021-11-20 11:32:20",
22. "host": "117.92.121.222:11136",
23. "region": "江苏省连云港市电信"
24. }
25. ],
26. "Num": 3,
27. "TaskID": "mw13Wq0srzt9uLEt"
28. }

5.错误码

1.接口描述

接口地址：https://proxy.zzqidc.com/query

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

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

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

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

2.输入参数说明

3.返回值

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

4.示例

请求接口示例：

1. https://proxy.zzqidc.com/query?Key=请改成您的Key

返回示例：

1. {
2. "Code ":0,
3. "TotalNum":5,
4. "TaskNum":5,
5. "TaskList ": [
6. {
7. "IP ": "127.0.0.1",
8. "port ": "49168",
9. "deadline ": "2018-05-11 02:56:02",
10. "host ": "127.0.0.1:49168",
11. }
12. ]
13. }

5.错误码

1.接口描述

接口地址：https://proxy.zzqidc.com/release

本接口用于释放申请到的IP，以便于再次进行IP申请。

该接口单个Key的请求资源释放限制为：（通道数*2）次/分钟；

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

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

2.输入参数说明

3.返回值

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

4 示例

请求接口示例：

1. https://proxy.zzqidc.com/release?Key=请改成您的Key

返回示例：

1. {
2. "Code ":0
3. }

5.错误码

1.接口描述

接口地址： https://proxy.zzqidc.com/monopolize_resources

本接口是用于获取用户已占用到且可用的独占资源列表。

请求频率限制：60次/分钟；

方法：GET；

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

2.输入参数说明

3.返回值

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

4 示例

请求接口示例：

1. curl https://proxy.zzqidc.com/monopolize_resources?Key=XXXX&UUIDs=XXX

返回示例：

1. {
2. data: [{
3. "uuid": "fj_qzdx9-1:ppp10",
4. "area": “河南省郑州市”,
5. "area_code": 350500,
6. "operator": "电信",
7. "operator_code": 1,
8. "state": 1, //已独占、排队中
9. "wait_seconds": 35, //排队等待秒数，已独占状态秒数为0
10. "monopolize_time": "2022-02-17 14:01:05", //独占时间
11. "last_dial_time": "2022-02-17 14:01:05", //最近一次拨号时间
12. "newest_ip": "127.0.0.1:10800",
13. "redialing": 0, //是否重拨中
14. "report_ts": "2022-02-17 14:01:05",
15. },{
16. ...
17. }]
18. }

5.错误码

1.接口描述

接口地址：https://proxy.zzqidc.com/replace

本接口用于替换代理IP。
该接口单个Key的请求频率限制为：（通道数*5）+10 次/分钟；
方法：HTTP、GET，需要注意不能混合使用；
编码：参数和返回内容均采用utf-8编码。

2.输入参数说明

3.返回值

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

4 示例

请求接口示例：

1. https://proxy.zzqidc.com/replace?Key=请改成您的Key

返回示例：

1. {
2. "Code ":0,
3. "TaskID ":"91107E16D28AC5A",
4. "Num " : "1"
5. "Data": [
6. "IP ": "127.0.0.1",
7. "port ": "49168",
8. "deadline ": "2018-05-11 02:56:02",
9. "host ": "127.0.0.1:49168",
10. ]
11. }

5.错误码

1.接口描述

接口地址： https://proxy.zzqidc.com/monopolize_resources

本接口是用于释放申请到的独占IP，以便于再次进行独占IP申请。

请求频率限制：按时业务是（通道数*5＋10）次/分钟；

方法：DELETE；

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

2.输入参数说明

3.返回值

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

4 示例

请求接口示例：

1. curl -X DELETE https://proxy.zzqidc.com/monopolize_resources?Key=XXX&UUIDs=XX,XXXX

返回示例：

1. {
2. "data": ["fj_xmdx2-1:ppp10"]
3. }

5.错误码

1.接口描述

接口地址： https://proxy.zzqidc.com/monopolize_resources/newest_ips

本接口是用于请求重拨独占资源。

请求频率限制：按时业务是（通道数*5＋10）次/分钟；

方法：PUT ；

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

2.输入参数说明

3.返回值

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

4 示例

请求接口示例：

1. curl -X PUT -d 'Key=XXX&UUIDs=XXX,XXX' https://proxy.zzqidc.com/monopolize_resources/newest_ips

返回示例：

1. {
2. data: ["fj_qzdx1-2:ppp1"] //重拨成功的资源uuids
3. }

5.错误码

1.请求结构：

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

2.公共参数

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

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

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

4.释放次数限制

5.通信协议

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

6.请求方法

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

7.字符编码

均使用UTF-8编码。

1.说明

通过编码使用动态独享代理主要有以下三步骤：
（1）先在会员中心上查看购买的动态独享代理，进行本地调试和验证；查看测试步骤＞＞

（2）参考代码样例请求动态独享代理；

（3）在程序中通过调用API接口获取代理，然后请求目标网站。

2.API接口

动态独享代理API接口一览

动态独享代理只提供给单个客户使用，独占IP和带宽资源，因此新增replace、release。