查询可用共享中继

查询可用共享中继的基本信息，包括你创建的和你的服务提供商授权给你的中继。

请求 URL

GET {base_url}/dm/open_api/v1/shared_trunk/name/acl

请求参数

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

格式：Bearer {access_token}。

响应参数

参数 类型 说明
data Array <Details> 共享中继基本信息列表。
requestId String 请求 ID，作为该请求的唯一标识，用于快速定位请求。
status String 请求结果。
  • Success：请求成功。
  • Failed：请求失败。
time Long 请求响应的时间。
注： YCM API 响应返回的是时间戳，如有需要，你可以将时间戳转换成具体的日期和时间。详细操作方法，请参见 将时间戳转换为日期和时间。
Details
参数 类型 说明
id Integer 共享中继的 ID。
name String 共享中继的名称。
type String 共享中继的类型。
  • register：注册中继。
  • did_based：点对点中继 (基于 DID)。
  • port_based：点对点中继 (基于端口)。

示例

请求示例

GET /dm/open_api/v1/shared_trunk/name/acl HTTP/1.1
Host: ycm.yeastar.com
Authorization: Bearer ******

响应示例

HTTP/1.1 200 OK
{
    "data": [
        {
            "id": 325,
            "name": "A1_07L3RG",
            "type": "register"
        },
        {
            "id": 7863,
            "name": "register_2PNG39",
            "type": "register"
        },
        {
            "id": 111269,
            "name": "register_1U4CZ4",
            "type": "did_based"
        },
        {
            "id": 111270,
            "name": "register_2V03D2",
            "type": "register"
        },
        {
            "id": 112129,
            "name": "register_5FOV41",
            "type": "register"
        }
    ],
    "requestId": "e1e7c70b1709dbaef13dfae2bf0a0cae",
    "status": "Success",
    "time": 1766552825
}