API文档>使用相关>资源相关 > 申请独占资源

申请独占资源

发布时间:2022-06-01 00:00

1.接口描述

接口地址: https://proxy.yunkv.com/monopolize_resources

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

请求频率限制:按时业务是(通道数*5+10)次/分钟;

方法: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=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",
  },{
  ...
  }]
}

 

5.错误码

错误码 描述
201 创建成功
404 独占资源不足
400 通道数不足
500 下放白名单失败
本文导读

客户热线:1830934534