Query Specific Trunk Access Permissions Granted to Specific User

Request URL

GET {base_url}/dm/open_api/v1/trunk_acl/dids

Request parameters

Headers


Parameter	Required	Type	Description
Authorization	Yes	String	Pass the access token in the header. Format: Bearer `{access_token}`.

Query parameters


Parameter	Required	Type	Description
userId	Yes	Long	The ID of the subordinate user. Note: You can query the user ID using Query All Trunk Access Permissions.
trunkIds	Yes	Array<Integer>	The ID list of assigned shared trunks. Note: This parameter contains up to 20 trunk IDs. You can query the trunk ID using Query Trunk Access Permissions Granted to Specific User. Use a comma to separate multiple IDs.

Response parameters


Parameter	Type	Description
data	Object <Details>	The detailed information.
requestId	String	The unique ID of the request, which can be used to quickly locate the request.
status	String	Request result: `Success` `Failed`
time	Long	The response time. Note: The YCM API response returns a timestamp, you can convert the timestamp to detailed date and time as needed. For more information, see Convert Timestamp to Local Date and Time.

Details


Parameter	Type	Description
trunkId	Integer	The ID of the shared trunk.
trunkName	String	The name of the shared trunk.
didList	Array<DID_Info>	The information of DID numbers associated with the shared trunk.

DID_Info


Parameter	Type	Description
didId	Integer	The ID of the DID number.
did	String	The DID number.

Example

Request example

Query access permissions of the trunks (ID: 5111 and 5096) granted to the subordinate user (ID: 1163).

GET /dm/open_api/v1/trunk_acl/dids?userId=1163&trunkIds=5111,5096 HTTP/1.1
Host: ycm.yeastar.com
Authorization: Bearer ******

Response example

HTTP/1.1 200 OK
{
    "data": [
        {
            "trunkId": 5111,
            "trunkName": "dxy_9CY41J",
            "didList": [
                {
                    "didId": 28075,
                    "did": "1212001"
                },
                {
                    "didId": 28176,
                    "did": "12120029"
                }
            ]
        },
        {
            "trunkId": 5096,
            "trunkName": "dxy_35VJJ7",
            "didList": [
                {
                    "didId": 28051,
                    "did": "8989012"
                },
                {
                    "didId": 28052,
                    "did": "8989013"
                },
                {
                    "didId": 28053,
                    "did": "8989014"
                },
                {
                    "didId": 28054,
                    "did": "8989015"
                }
            ]
        }
    ],
    "requestId": "S0V4PYds",
    "status": "Success",
    "time": 1766386989
}