获取代理IP-产品介绍-青果网络

## 1  API调用提取

对于短效代理、独享代理、长效代理，我们都提供了API接口，方便开发者批量获取代理IP。

接口返回数据的格式支持文本、json、xml。

获取IP接口文档：

- [短效代理IP资源提取 ＞](https://www.qg.net/doc/2255.html)
- [独享代理IP资源提取 ＞](https://www.qg.net/doc/1840.html)
- [长效代理IP资源提取 ＞](https://www.qg.net/doc/1863.html)

隧道代理无需调用API提取代理，其他接口参见：[API接口概览](https://www.qg.net/doc/2145.html)

##  2 生成API链接

你可以在【提取工具】或【调试工具】生成API链接在线提取IP，方便集成到您的程序或软件中。

### 2.1 提取工具

选择已购买可用的AuthKey值,根据实际需求提取对应的IP，点击【生成链接】获取在线API链接，【打开链接】新窗口打开获取申请成功的IP信息，如下图所示；
![image-20221117180155629](https://article.qg.net/Uploads/image/2022-11-17/180157db531bf.png)

![image-20221118100301638](https://article.qg.net/Uploads/image/2022-11-18/1003020935c8e.png)

### 2.2 调试工具

首先勾选要进行提取的业务key，key为必选项，是对接接口的必要信息；

其次，选择接口方法，不同的产品可选择的提取接口不同。

短效代理可选择【提取IP资源】、【获取IP池资源】接口，接口【获取IP池资源】是获取IP资源池全部可用的IP，资源池指的是购买短效代理的多通道形成的小资源池；

独享代理提取接口可选择【提取IP资源】、【更换IP资源】，接口【更换IP资源】是释放IP并申请新的IP；

长效代理提取接口可选择【提取IP资源】；

然后，其他选项IP数量、地区、运营商按需选择，最后点击【测试】按钮即可进行IP提取,申请成功返回结果为如下图所示；
![image-20221117174206373](https://article.qg.net/Uploads/image/2022-11-17/174208ba8399a.png)

## 3 测试API链接

### 3.1 浏览器测试

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

https://proxy.qg.net/query?Key=0B***607

###3.2 命令行测试

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

```
curl "https://proxy.qg.net/allocate?Key=请改成您的Key
```

## 4 接口返回错误码

| 错误码  | 描述  |
| ------------ | ------------ |
| -1  | 未知错误  |
| -10  | 参数不合法  |
| -11     | 请求过于频繁            |
| -100  | 计划不存在或已过期  |
| -101  | 请求数量超过计划通道数  |
| -102  | 没有剩余的可用通道  |
| -103  | 资源不足  |
| -104  | 资源申请失败 |
| -105  | 申请的IP数超过允许申请的IP数  |

每个接口自己的错误码请参见各接口文档。

## 5 代码样例
- [代码示例-Python](https://www.qg.net/doc/81.html)
- [代码示例-Java](https://www.qg.net/doc/82.html)
- [代码示例-PHP](https://www.qg.net/doc/83.html)