API文档>使用相关>资源相关 > 查询可用独占资源

查询可用独占资源

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

1.接口描述

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

本接口是用于获取用户已占用到且可用的独占资源列表。

请求频率限制:60次/分钟;

方法:GET;

编码:参数和返回内容均采用utf-8编码。

2.输入参数说明

参数名 是否必选 类型 描述
Key String 查询独占资源的Key值;
UUIDs String 独占资源编号,多个用逗号隔开。

3.返回值

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

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

4 示例

请求接口示例:

  1. curl https://proxy.yunkv.com/monopolize_resources?Key=XXXX&UUIDs=XXX

返回示例:

  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.错误码

错误码 描述
200 查询成功
500 未知错误
本文导读