1.接口描述

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

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

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

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

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

2.输入参数说明

3.返回值

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

4 示例

请求接口示例：

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

返回示例：

1. {
2. "Code ":0,
3. "Data ": [
4. {
5. "AreaId ": "320382 ",
6. "AreaName ": "福建泉州市",
7. "Isp": "1",
8. "IspName ": "电信",
9. "Status ": "1",
10. }
11. ]
12. }

5.错误码

1.接口描述

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

本接口是用于查询空闲可申请的独占资源。

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

方法：GET；

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

2.输入参数说明

3.返回值

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

4 示例

请求接口示例：

1. curl https://proxy.zzqidc.com/monopolize_resources/idle?Key=XXXX

返回示例：
`

1. {
2. data: [{
3. "area": “福建省泉州市”,
4. "area_code": 350500,
5. "operator": "电信",
6. "operator_code": 1,
7. "idle": 30
8. },{
9. ...
10. }]
11. }
12. `

5.错误码

1.接口描述

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

本接口用于添加IP的白名单。

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

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

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

2.输入参数说明

3.返回值

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

4 示例

请求接口示例：

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

返回示例：

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

5.错误码

1.接口描述

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

本接口用于查询IP的白名单。

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

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

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

2.输入参数说明

3.返回值

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

4.示例

请求接口示例：

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

返回示例：

1. {
2. "Code ":0,
3. "Num",1
4. Data:[
5. "192.168.1.1",
6. "192.168.1.2"
7. ]
8. }

5.错误码

1.接口描述：

本接口用于删除IP的白名单。接口请求地址https://proxy.zzqidc.com/whitelist/del

注：该接口单个Key的请求频率限制为：20 次/分钟

2.输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

3.输出参数

4.错误码

公共错误码：

-1 未知错误

-10 参数不合法!

-100 计划不存在或已过期!

-101 请求数量超过计划通道数!

-102 没有剩余的可用通道。

5.请求示例

请求参数：
https://proxy.zzqidc.com/whitelist/del?<公共请求参数>

返回参数，JSON格式，详情如下：

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

1.接口描述

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

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

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

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

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

2.输入参数说明

业务为按量动态共享时，参数“KeepAlive“、”Distinct”无须输入；
业务为按时动态共享、按时静态独享时，参数“KeepAlive“无须输入。

3.返回值

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

4 示例

请求接口示例：

1. https://proxy.zzqidc.com/allocate?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资源。

请求频率限制：按时业务是（通道数*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.错误码