申请独占资源-产品介绍-青果网络

## 1 接口描述
接口地址： https://proxy.qg.net/monopolies
本接口是用于请求申请独占代理IP资源。
方法：POST；
编码：参数和返回内容均采用utf-8编码。

## 2 输入参数说明

| 参数名   | 是否必选 | 类型    |         描述          |
| :------- | :------- | :------ | :-------------------: |
| Key      | 是       | String  | 申请独占资源的Key值 |
| AreaCode | 否       | Integer |  地区编码，默认随机  |
| Operator | 否       | Integer |  运营商，默认随机   |
| Num      | 否       | Integer |    数量，默认为1    |

## 3 返回值

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

| 返回字段 | 类型   |      描述      |
| :------- | :----- | :------------: |
| data     | Array  | 独占资源列表 |
| error    | String |   错误信息   |

## 4 示例

请求接口示例：

```
curl -X POST -d 'Key=请改成您的Key&AreaCode=XX&Operator=XXX&Num=1' 'https://proxy.qg.net/monopolies'
```

返回示例：
```
{
	"data": [{
		"uuid": "fj_qzdx9-1:ppp10",
		"area": “福建省泉州市”,
		"operator": "电信",
		"state": "排队(123)", //分成在线、离线、重拨中、排队中(等待秒数X)
		"monopolize_time": "2022-02-17 14:01:05", //独占时间
	},{
	...
	}]
}
```

## 5 接口返回错误码

| 错误码 |      描述      |
| :----: | :------------: |
|  201   |    创建成功    |
|  400  |  独占资源不足 |
|  400  |  通道数不足 |
|  500   | 下放白名单失败 |