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

申请独占资源

发布时间:2022-07-02 02:25

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 示例

请求接口示例:

  1. curl -X POST -d 'Key=XXX&AreaCode=XX&Operator=XXX&Num=XXX' https://proxy.yunkv.com/monopolize_resources

返回示例:

  1. {
  2. data: [{
  3. "uuid": "fj_qzdx9-1:ppp10",
  4. "area": “福建省泉州市”,
  5. "area_code": 350500,
  6. "operator": "电信",
  7. "operator_code": 1,
  8. "state": 1, //已独占、排队中
  9. "wait_seconds": 35, //排队等待秒数,已独占状态秒数为0
  10. "monopolize_time": "2022-02-17 14:01:05", //独占时间
  11. "last_dial_time": "2022-02-17 14:01:05", //最近一次拨号时间
  12. "newest_ip": "127.0.0.1:10800",
  13. "redialing": 0, //是否重拨中
  14. "report_ts": "2022-02-17 14:01:05",
  15. },{
  16. ...
  17. }]
  18. }

5.错误码

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