授予指定用户中继访问权限

授予下级用户一条或多条共享中继及其 DID 号码的访问权限。

请求 URL

POST {base_url}/dm/open_api/v1/trunk_acl

请求参数

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

格式：Bearer {access_token}。
请求体
参数 是否必填 类型 说明
userId 是 Long 下级用户的 ID。
注： 可使用 查询所有下级用户 查询用户 ID。
trunkDidList 是 Array<Trunk_Info> 共享中继的 ID 及其关联的 DID 号码的 ID 列表。
Trunk_Info
参数 是否必填 类型 说明
trunkId 是 Integer 要分配的共享中继的 ID。
注： 可使用 查询可用共享中继 查询中继 ID。
didIds 是 Array<Integer> 要分配的 DID 号码的 ID 列表。
注：

响应参数

参数 类型 说明
requestId String 请求 ID，作为该请求的唯一标识，用于快速定位请求。
status String 请求结果。
  • Success：请求成功。
  • Failed：请求失败。
time Long 请求响应的时间。
注： YCM API 响应返回的是时间戳，如有需要，你可以将时间戳转换成具体的日期和时间。详细操作方法，请参见 将时间戳转换为日期和时间。

示例

请求示例

POST /dm/open_api/v1/trunk_acl HTTP/1.1
Host: ycm.yeastar.com
Authorization: Bearer ******
Content-Type: application/json
{
    "userId": 359054,
    "trunkDidList": [
        {
            "trunkId": 325,
            "didIds": [1185793]
        }
    ]
}

响应示例

HTTP/1.1 200 OK
{
  "requestId": "361350ac8a83708c785177513c5331a5",
  "status": "Success",
  "time": 1747027810
}