搜索特定分机

在分机列表中搜索特定分机。

请求 URL

GET {base_url}/{api_path}/extension/search?access_token={access_token}

请求参数

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

取值范围：

  • id
  • number
  • caller_id_name
  • email_addr
  • mobile_number
  • presence_status
order_by 否 String 定义显示顺序。

取值范围：

  • asc：升序
  • desc：降序
search_value 否 String 搜索关键字。

响应参数

表 2.
参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
total_number Integer 搜索到的分机总数。
data Array<Ext_Basicinfo> 分机基本信息。
Ext_Basicinfo
表 3.
参数 类型 说明
id Integer 分机的唯一 ID。
online_status Object<Online_Status> 分机的终端在线状态，包含以下终端：
  • fxs_phone：FXS 话机。
  • sip_phone：SIP 终端。
  • linkus_desktop：Linkus 桌面端。
  • linkus_mobile：Linkus 手机端。
  • linkus_web：Linkus 网页端。
presence_status String 分机状态。
  • available：空闲
  • away：离开
  • business_trip：出差
  • do_not_disturb：免打扰 (DND)
  • lunch：午休
  • off_work：下班
number String 分机号码。
caller_id_name String 用户名称。
role_name String 用户角色。
email_addr String 邮箱地址。
mobile_number String 手机号码。
Online_Status
表 4.
参数 类型 说明
status Integer 分机的终端在线状态 (SIP 终端除外)。
注： 分机在 SIP 终端上的在线状态会在 status_list 中返回。
  • 0：离线
  • 1：在线
ext_dev_type String 在线终端类型。
  • fxs：FXS 话机。
  • sip：SIP 终端。
  • linkusdesktop：Linkus 桌面端。
  • linkusmobile：Linkus 手机端。
  • linkusweb：Linkus 网页端。
status_list Array<Status_List> 分机在 SIP 终端上的在线信息详情。
注： 该参数仅在分机注册在 SIP 终端时返回。
Status_List
表 5.
参数 类型 说明
status Integer 分机在 SIP 终端的在线状态。
  • 0：离线
  • 1：在线
ip String SIP 终端的 IP 地址和 SIP 端口。

例如：192.168.28.190:5060。
linkus_dev_type String 在线 Linkus 手机端和 Linkus 平板端 (SDK) 的类型。
  • ios: Linkus 手机端 iOS 版本。
  • android: Linkus 手机端安卓版本。
  • ipad: Linkus 平板端 (SDK) iOS 版本。
  • pad: Linkus 平板端 (SDK) 安卓版本。

示例

请求示例

从分机列表中搜索分机 2000。

GET /openapi/v1.0/extension/search?order_by=asc&search_value=2000&access_token=U9MgMoxtQTBIF1Kb2RJZ9piWeLTd2Krd HTTP/1.1
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "total_number": 1,
    "data": [
        {
            "id": 238,
            "online_status": {
                "fxs_phone": {
                    "status": 0
                },
                "sip_phone": {
                    "status": 0,
                    "ext_dev_type": "sip",                  //分机 2000 注册在 SIP 终端上。
                    "status_list": [                       
                        {
                            "status": 1,                    //分机在 SIP 终端上的在线状态
                            "ip": "192.168.28.190:5060"     //SIP 终端的 IP 地址和 SIP 端口
                        }
                    ]
                },
                "linkus_desktop": {
                    "status": 0
                },
                "linkus_mobile": {
                    "status": 1,
                    "ext_dev_type": "linkusmobile",
                    "status_list": [
                        {
                            "status": 1,
                            "ip": "112.48.22.71",
                            "linkus_dev_type": "android"
                        }
                    ]
                },
                "linkus_web": {
                    "status": 0
                }
            },
            "presence_status": "available",
            "number": "2000",
            "caller_id_name": "Leo Ball",
            "role_name": "Administrator",
            "email_addr": "leo@sample.com"
        }
    ]
}