接口地址: https://proxy.yunkv.com/monopolize_resources
本接口是用于请求申请独占代理IP资源。
请求频率限制:按时业务是(通道数*5+10)次/分钟;
方法:POST;
编码:参数和返回内容均采用utf-8编码。
参数名 | 是否必选 | 类型 | 描述 |
---|---|---|---|
Key | 是 | String | 申请独占资源的Key值; |
AreaCode | 否 | Integer | 地区编码;默认随机; |
Operator | 否 | Integer | 运营商,默认随机; |
Num | 否 | Integer | 数量,默认为1。 |
接口可返回文本格式、json格式、xml格式,字段说明如下:
返回字段 | 类型 | 描述 |
---|---|---|
data | Array | 独占资源列表; |
error | String | 错误信息。 |
请求接口示例:
curl -X POST -d 'Key=XXX&AreaCode=XX&Operator=XXX&Num=XXX' https://proxy.yunkv.com/monopolize_resources
返回示例:
{
data: [{
"uuid": "fj_qzdx9-1:ppp10",
"area": “福建省泉州市”,
"area_code": 350500,
"operator": "电信",
"operator_code": 1,
"state": 1, //已独占、排队中
"wait_seconds": 35, //排队等待秒数,已独占状态秒数为0
"monopolize_time": "2022-02-17 14:01:05", //独占时间
"last_dial_time": "2022-02-17 14:01:05", //最近一次拨号时间
"newest_ip": "127.0.0.1:10800",
"redialing": 0, //是否重拨中
"report_ts": "2022-02-17 14:01:05",
},{
...
}]
}
错误码 | 描述 |
---|---|
201 | 创建成功 |
404 | 独占资源不足 |
400 | 通道数不足 |
500 | 下放白名单失败 |