查询分机状态监控设置

查询 API 功能中的分机状态监控设置。

请求 URL

GET {base_url}/{api_path}/extension_status_monitor/list?access_token={access_token}

请求参数

参数 是否必填 类型 说明
page 否 Integer 定义显示第几个页面。
page_size 否 Integer 定义每页显示几项查询结果。
sort_by 否 String 定义排序字段。

取值范围：

  • ext_id
order_by 否 String 定义显示顺序。

取值范围：

  • asc：升序

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
total_number Integer 分机的总数。
data Array<Monitoring_Settings> 分机的状态监控设置。
Monitoring_Settings
参数 类型 说明
ext_id Integer 分机的唯一 ID。
number String 分机号码。
name String 分机名称。
enb_register_status Integer
是否启用了注册状态监控。
  • 0：禁用
  • 1：启用
enb_call_status Integer 是否启用了通话状态监控。
  • 0：禁用
  • 1：启用
enb_presence_status Integer 是否启用了出席状态监控。
  • 0：禁用
  • 1：启用

示例

请求示例

GET /openapi/v1.0/extension_status_monitor/list?access_token=bZDofvFsZ6oMkZgII195h1BzLa0co5o4&page=1&page_size=4&sort_by=ext_id&order_by=asc HTTP/1.1

Host: yeastardocs.example.yeastarcloud.com

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "total_number": 12,
    "data": [
        {
            "ext_id": 9,
            "number": "1000",
            "name": "Leo Ball",
            "enb_register_status": 0,
            "enb_call_status": 1,
            "enb_presence_status": 0
        },
        {
            "ext_id": 10,
            "number": "1001",
            "name": "Phillip Huff",
            "enb_register_status": 1,
            "enb_call_status": 1,
            "enb_presence_status": 0
        },
        {
            "ext_id": 4,
            "number": "1002",
            "name": "Terrell Smith",
            "enb_register_status": 0,
            "enb_call_status": 0,
            "enb_presence_status": 1
        },
        {
            "ext_id": 5,
            "number": "1003",
            "name": "Dave Harris",
            "enb_register_status": 0,
            "enb_call_status": 0,
            "enb_presence_status": 0
        }
    ]
}