代理IP API概览-产品介绍-青果网络

## 1 接口简介
青果代理IP提供了功能丰富的API接口，满足开发者在各种场景下的调用需求。

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

具体请参见接口文档。

## 2 API列表

- [动态共享代理](https://www.qg.net/doc/1564.html "动态共享代理")
- [动态独享代理](https://www.qg.net/doc/1565.html "动态独享代理")
- [动态独占代理](https://www.qg.net/doc/1570.html "动态独占代理")
- [隧道共享代理](https://www.qg.net/doc/1567.html "隧道共享代理")
- [静态独享代理](https://www.qg.net/doc/1568.html "静态独享代理")

## 3 测试代理可用性
 ###  3.1 生成API链接
对于代理提取API，您可以到提取工具在线生成API链接，内置到您的程序中：

[提取代理API链接生成 ＞](https://www.qg.net/tools/IPget.html "提取代理API链接生成 ＞＞")

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

###  3.2 测试API链接
 **浏览器测试**

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

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

**命令行测试**

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

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

## 4 接口返回错误码
公共接口返回错误码

| 错误码 | 描述                       |
| ------ | ------------------------- |
| -1      | 未知错误                  |
| -10     | 参数不合法                |
| -11     | 请求过于频繁              |
| -12     | Authkey被封禁             |
| -13     | 当前客户端IP不在授权名单中  |
| -14     | Pwd不合法                 |
| -15     | Authkey对应的业务无此权限  |
| -100    | 计划不存在或已过期         |
| -103    | 资源不足                  |
| -104    | 申请资源失败               |
| -105    | 释放的IP数超过允许释放的IP数 |

## 5 代码样例
查看API调用的[代码样例 ＞](https://www.qg.net/doc/172.html)