Search Specific Extension Groups

Search specific extension group from the extension group list.

Request URL

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

Request parameters

Parameter Required Type Description
page No Integer Define which page is displayed.
page_size No Integer Define how many records per page.
sort_by No String Define the sorting field.

Valid value:

  • id
  • name
order_by No String Define the display order.

Valid value:

  • asc: Ascending order.
  • desc: Descending order.
search_value No String Search keyword.

Response parameters

Parameter Type Description
errcode Integer Returned error code.
  • 0: Succeed.
  • Non-zero value: Failed.
Note: You can check the error code and error message in Error Code and Error Message.
errmsg String Returned message.
  • SUCCESS: Succeed.
  • FAILURE: Failed.
total_number Integer The total of the searched extension groups.
data Array<ExtGroup_info> The information of the extension group.
ExtGroup_info
Parameter Type Description
id Integer Extension Group ID.
name String Extension Group name.
member_select String How extensions are added to the group.
  • sel_all_ext: All extensions are added.
  • sel_specific: Only specified extensions are added.
total_extensions Integer The total number of member extensions in the group.

Examples

Request example

Search for extension group "Default_All_Extensions" from the extension list.

GET /openapi/v1.0/extensiongroup/search?access_token=Hb19mIhO9E1lfCWCF01P9D4R7MiG1Jow&search_value=Default_All_Extensions HTTP/1.1
Host: 192.168.5.150:8088

Response example

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "total_number": 1,
    "data": [
        {
            "id": 1,
            "name": "Default_All_Extensions",
            "member_select": "sel_all_ext",
            "total_extensions": 36
        }
    ]
}