Query Information of Multiple Onsite Proxy Instances

Query the detailed information of multiple Onsite Proxy instances at the same time.

Request URL

GET {base_url}/{api_path}/onsiteproxy/query?access_token={access_token}

Request parameters

Parameter	Required	Type	Description
ids	Yes	String	The unique ID(s) of Onsite Proxy instance(s). Note: You can query instance ID using Search Specific Onsite Proxy Instances. Use a comma to separate multiple IDs.

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.
data	Array<Proxy_DetailInfo>	The detailed information of each Onsite Proxy instance.

Proxy_DetailInfo

Parameter	Type	Description
id	Integer	The instance ID.
uuid	String	The instance UUID.
name	String	The instance name.
platform	String	The operating system where the instance is deployed.
version	String	The instance version.
intranet_ip	String	The private IP address of the instance.
public_ip	String	The public IP address of the instance.
intranet_port	Integer	The internal port of the instance.
audio_rtp_passthrough	Integer	Whether the Audio RTP Passthrough feature is enabled. 0: Disabled 1: Enabled
status	String	The connection status between the PBX and the instance. connected: The instance is normally connected to the PBX. disconnected: The instance is disconnected from the PBX. abnormal: The system resources utilization for the instance has exceeded any if the following thresholds: The CPU utilization exceeds 85%. The memory utilization exceeds 85%. The disk utilization exceeds 95%.
status_update_time	Integer	The timestamp when the connection status was last updated.
phone_count	Integer	The total number of associated IP phones, including those auto-discovered via PnP by the instance and others configured to register via the instance.
online_phone_count	Integer	The number of associated IP phones successfully registered with PBX extensions via the instance.
last_report_time	Integer	The timestamp when the instance last reported data to the PBX.
cpu_usage	Number	The CPU utilization for the instance.
memory_usage	Number	The memory utilization for the instance.
disk_usage	Number	The disk utilization for the instance.
create_time	Integer	The timestamp when the instance was created.
update_time	Integer	The timestamp of the last update to the instance data, excluding phone count and online phone count changes.
secret_key_activated	Integer	Whether the secret key is activated. 0: Unactivated 1: Activated
connection_address	String	The connection address of the PBX server.

Examples

Request example

Query the detailed information of Onsite Proxy instances (ID: 24 & 56).

GET /openapi/v1.0/onsiteproxy/query?ids=24,56&access_token=mZFtXNfGBlo6gR9FR8Tjz0iDJRqCe3RL HTTP/1.1
Host: 192.168.5.150:8088

Response example

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "data": [
        {
            "id": 24,
            "uuid": "80XXX-XXXX-XXXX-XXXX-XXXXXXXXXca4",
            "name": "Proxy_010",
            "platform": "linux",
            "version": "99.0.0.9",
            "intranet_ip": "172.17.0.42",
            "public_ip": "192.0.2.12",
            "intranet_port": 5060,
            "audio_rtp_passthrough": 1,
            "status": "disconnected",
            "status_update_time": 1772604748,
            "phone_count": 5,
            "online_phone_count": 0,
            "last_report_time": 1772610988,
            "cpu_usage": 1.3360221,
            "memory_usage": 37.36399,
            "disk_usage": 52.64806,
            "create_time": 1769753209,
            "update_time": 1772422881,
            "secret_key_activated": 1,
            "connection_address": "198.51.100.10"
        },
        {
            "id": 56,
            "uuid": "a1XXX-XXXX-XXXX-XXXX-XXXXXXXXX9cf",
            "name": "Proxy_042",
            "platform": "linux",
            "version": "99.0.0.9",
            "intranet_ip": "172.17.0.10",
            "public_ip": "192.0.2.17",
            "intranet_port": 5060,
            "audio_rtp_passthrough": 1,
            "status": "disconnected",
            "status_update_time": 1772604748,
            "phone_count": 0,
            "online_phone_count": 0,
            "last_report_time": 1772611006,
            "cpu_usage": 1.6509137,
            "memory_usage": 37.374653,
            "disk_usage": 52.64812,
            "create_time": 1769753211,
            "update_time": 1772422967,
            "secret_key_activated": 1,
            "connection_address": "198.51.100.10"
        }
    ]
}