查询所有中继访问权限

查询授予给下级用户的中继访问权限。

请求 URL

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

请求参数

请求头
参数 是否必填 类型 说明
Authorization 是 String 在请求头中传递访问 Token。

格式：Bearer {access_token}。
查询参数
参数 是否必填 类型 说明
pageNumber 否 Integer 定义显示第几个页面。
  • 默认值：1
pageSize 否 Integer 定义每页显示几项查询结果。
  • 默认值：10
  • 最大值：50
query 否 String 输入关键字进行模糊搜索。

响应参数

参数 类型 说明
data Object <Details> 详情。
requestId String 请求 ID，作为该请求的唯一标识，用于快速定位请求。
status String 请求结果。
  • Success：请求成功。
  • Failed：请求失败。
time Long 请求响应的时间。
注： YCM API 响应返回的是时间戳，如有需要，你可以将时间戳转换成具体的日期和时间。详细操作方法，请参见 将时间戳转换为日期和时间。
Details
参数 类型 说明
pageSize Integer 每页显示几项查询结果。
pageNumber Integer 当前显示第几页。
total Integer 中继访问权限总数。
list Array <Trunk_Access_Permission> 授予给下级用户的中继访问权限列表。
Trunk_Access_Permission
参数 类型 说明
userId Long 下级用户的 ID。
userName String 用户名。
userEmail String 用户邮箱。
trunkList Array<Trunk_Info> 已分配的共享中继列表。

Trunk_Info

参数 类型 说明
trunkId Integer 共享中继的 ID。
trunkName String 共享中继的名称。

示例

请求示例

查询中继访问权限列表：
  • 每页返回 3 条记录。
  • 显示第一页记录。
GET /dm/open_api/v1/trunk_acl/page?pageNumber=1&pageSize=3 HTTP/1.1
Host: ycm.yeastar.com
Authorization: Bearer ******

响应示例

HTTP/1.1 200 OK
{
    "data": {
        "pageSize": 3,
        "pageNumber": 1,
        "total": 7,
        "list": [
            {
                "userId": 1143,
                "userName": "Sophia",
                "userEmail": "sophia@yeastar.com",
                "trunkList": [
                    {
                        "trunkId": 5091,
                        "trunkName": "hbl_ZG184D"
                    }
                ]
            },
            {
                "userId": 1145,
                "userName": "Malinda",
                "userEmail": "malinda@yeastar.com",
                "trunkList": [
                    {
                        "trunkId": 5229,
                        "trunkName": "gd_597RXM_S5H46P"
                    }
                ]
            },
            {
                "userId": 1150,
                "userName": "Charlotte",
                "userEmail": "charlotte@yeastar.com",
                "trunkList": [
                    {
                        "trunkId": 5092,
                        "trunkName": "port_KY540C"
                    },
                    {
                        "trunkId": 5097,
                        "trunkName": "dxy_LU6N33"
                    },
                    {
                        "trunkId": 5112,
                        "trunkName": "dxy_9TOO33"
                    }
                ]
            }
        ]
    },
    "requestId": "wBcbvXO8",
    "status": "Success",
    "time": 1766381383
}