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。

1.说明

通过编码使用动态独占代理主要有以下三步骤：
（1）先在会员中心上查看购买的动态独占代理，在“IP管理”中添加IP城市，获取的独占资源进行本地调试和验证；查看测试步骤＞＞

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

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

2.API接口

动态独占代理API接口一览

动态独占代理相对动态独享代理，除了可以独享宽带和IP，还可以指定城市，因此资源相关接口与其他代理都不一样。

1.说明

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

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

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

2.API接口

静态独享代理API接口一览

1.说明

通过编码使用动态共享代理主要有以下三步骤：
（1）先在提取工具或调试工具上提取动态共享代理，进行本地调试和验证；查看测试步骤＞＞

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

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

2.API接口

动态共享代理API接口一览

需要注意的是动态共享代理区分按时业务和按量业务，按时动态共享代理的默认提取接口是extract，按量动态共享代理的默认提取接口是allocate。

1.接口简介

快米云代理IP提供了功能丰富的API接口，满足开发者在各种场景下的调用需求。

所有接口支持 HTTP 或者 HTTPS 请求，部分接口采用 GET 方法，部分接口采用 POST 方法；接口返回数据的格式支持文本、json、xml。

具体请参见接口文档。

2.API列表

• 动态共享代理

• 动态独享代理

• 动态独占代理

• 隧道共享代理

• 静态独享代理

3. 测试代理可用性

3.1 生成API链接

对于代理提取API，您可以到提取工具在线生成API链接，内置到您的程序中：

提取理API链接生成 ＞＞

其他接口请查看API文档，获取接口url和参数说明，自己生成API链接。

3.2 测试API链接

（1）浏览器测试

您可以把生成的API链接直接在浏览器里打开，查看返回结果。例如，您直接点击如下api链接

https://proxy.zzqidc.com/query?Key=0B***607

（2）命令行测试

如果您在linux系统下，可以通过curl命令请求API链接查看结果：

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

4 .错误码

公共错误码

5. 代码样例

查看API调用的代码样例 ＞＞