搜索特定 IP 话机

从自动配置话机列表中搜索特定 IP 话机。

请求 URL

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

请求参数

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

取值范围：

  • vendor：话机供应商
  • model：话机型号
  • ip：话机 IP 地址
order_by 否 String 定义显示顺序。

取值范围：

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

响应参数

表 2.
参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
total_number Integer 搜索到的 IP 话机总数量。
data Array<Phone_Info> 搜索到的 IP 话机信息。
Phone_Info
表 3.
参数 类型 说明
id Integer IP 话机的唯一 ID。
mac String IP 话机的 MAC 地址。
vendor String 话机供应商。
model String 话机型号。
template_name String 应用到 IP 话机的配置模板的名称。
ip String IP 话机的私网 IP 地址。
注： 仅通过 PnP 方式配置的 IP 话机会返回 IP 地址，否则该参数返回空值。
firmware String IP 话机的固件版本。
assigned_ext_status String 分配给 IP 话机的分机的注册状态。
  • Unregistered：未注册。

  • Registered：已注册。
assigned_ext_num String 分配给 IP 话机的分机号码。
注： 如果该参数返回 Unassigned，表示此 IP 话机尚未分配分机。
assigned_ext_name String 分配给 IP 话机的分机用户姓名。
注： 如果该参数返回 Unassigned，表示此 IP 话机尚未分配分机。
rps_pin String 通过 RPS 方式配置的 亿联 (Yealink) 话机的 RPS PIN。如话机有要求，可在话机上输入此 PIN 码以完成 RPS 配置流程。
onsite_proxy_uuid String 关联的本地代理网关实例的 UUID。
function_key_line Integer SIP 线路的号码。分配给该 SIP 线路的分机的功能键将被应用到话机。
phonebook_line Integer SIP 线路的号码。分配给该 SIP 线路的分机的联系人群组将被应用到话机。
assigned_list Array<Extension_Info> 分配给话机 SIP 线路的分机信息。

Extension_Info

参数 类型 说明
status String 分配给 SIP 线路的分机的注册状态。
  • Unregistered

  • Registered

ext_num String 分配给 SIP 线路的分机号。
ext_name String 分配给 SIP 线路的分机的用户姓名。
sip_line Integer SIP 线路的号码。

示例

请求示例

GET /openapi/v1.0/phone/search?access_token=sSpTRV82rCV5Y8lOzb7yDBcRwvkqGjpe&page=1&page_size=3&sort_by=vendor&order_by=asc HTTP/1.1
Host: 192.168.5.150:8088
User-Agent: OpenAPI

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "total_number": 36,
    "data": [
        {
            "id": 14,
            "mac": "3c:xx:xx:xx:xx:39",
            "vendor": "Alcatel-Lucent Enterprise",
            "model": "M8",
            "template_name": "YSDP_AleM8",
            "ip": "192.168.28.237",
            "firmware": "2.13.01",
            "assigned_ext_status": "Unregistered",
            "assigned_ext_num": "2005",
            "assigned_ext_name": "Kristin Hale",
            "rps_pin": "",
            "onsite_proxy_uuid": "",
            "function_key_line": 1,
            "phonebook_line": 1,
            "assigned_list": [
                {
                    "status": "Unregistered",
                    "ext_num": "2005",
                    "ext_name": "Kristin Hale",
                    "sip_line": 1
                },
                {
                    "status": "Unregistered",
                    "ext_num": "2006",
                    "ext_name": "Emma Wilson",
                    "sip_line": 2
                }
            ]
        },
        {
            "id": 21,
            "mac": "3c:xx:xx:xx:xx:ae",
            "vendor": "Alcatel-Lucent Enterprise",
            "model": "M3",
            "template_name": "YSDP_AleMyriad",
            "ip": "192.168.28.207",
            "firmware": "2.13.39",
            "assigned_ext_status": "Unregistered",
            "assigned_ext_num": "2007",
            "assigned_ext_name": "Ashley Gardner",
            "rps_pin": "",
            "onsite_proxy_uuid": "",
            "function_key_line": 2,
            "phonebook_line": 1,
            "assigned_list": [
                {
                    "status": "Unregistered",
                    "ext_num": "2007",
                    "ext_name": "Ashley Gardner",
                    "sip_line": 1
                },
                {
                    "status": "Registered",
                    "ext_num": "5555",
                    "ext_name": "Daniel Kim",
                    "sip_line": 2
                }
            ]
        },
        {
            "id": 48,
            "mac": "00:xx:xx:xx:xx:54",
            "vendor": "Cisco",
            "model": "Cisco3905",
            "template_name": "YSDP_Cisco3905",
            "ip": "",
            "firmware": "",
            "assigned_ext_status": "Registered",
            "assigned_ext_num": "2003",
            "assigned_ext_name": "Dave Haris",
            "rps_pin": "",
            "onsite_proxy_uuid": "",
            "function_key_line": 1,
            "phonebook_line": 1,
            "assigned_list": [
                {
                    "status": "Registered",
                    "ext_num": "2003",
                    "ext_name": "Dave Haris",
                    "sip_line": 1
                }
            ]
        },
      ... ...
    ]
}