分配SIP中继 - Zoom API 中文版

使用SIP连接的音频，Zoom通过客户网络和Zoom云之间的直接和私有连接建立SIP中继 (专门用于拨打和拨打电话的网络连接)。拨入会议或让会议呼叫他们的会议参与者，并且从客户的IP电话网络的角度来看是在网上的，将通过此中继而不是通过PSTN连接。

使用此API将主帐户上可用的SIP中继分配给子帐户。
先决条件:

发出此API请求的帐户必须是具有 API合作伙伴计划和SIP连接音频计划的主帐户。

** 范围: ** 'sip_trunk:master'

请求参数

Path 参数

accountId

string

必需

子账户的唯一标识符。

Body 参数application/json

sip_trunks

array [object {3}]

可选

一个或多个SIP Trunk对象的数组。

>= 1 items<= 30 items

dnis

string

可选

子帐户的DNIS。DNIS的前缀 (即DNIS值的前五位) 必须与主账户的DNIS前缀匹配。要检索主帐户的SIP Trunk的DNIS前缀，请使用List SIP Trunk API并引用 “DNIS” 值中的前五位数字。

例如，如果主帐户的DNIS是1888812345，则子帐户的DNIS必须包含 “18888” “random_number”。DNIS的最大允许长度为8。

>= 5 字符<= 8 字符

示例值:

90001258

string

可选

将分配给子帐户的SIP中继的唯一标识符。此字段的值可以通过使用列表SIP Trunks API列出主帐户的SIP Trunks来检索。

示例值:

outbound_caller_id

string

可选

分配出站呼叫方Id到中继。

<= 32 字符

示例值:

示例

{
    "sip_trunks": [
        {
            "dnis": "90001258",
            "id": "1",
            "outbound_caller_id": "1"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201** HTTP状态代码: ** '204' ** 无内容 ** SIP中继分配成功。

application/json

Body

sip_trunks

array [object {5}]

可选

name

string

SIP中继的名称。

可选

示例值:

trunk1

sip_server_address

string

可选

SIP中继的IP地址或域。

示例值:

192.168.0.10

dnis

string

可选

DNIS-启用SIP中继的帐户的标识符。

示例值:

90001258

string

可选

SIP中继的唯一标识符。

示例值:

number_prefix

string

可选

如果此字段的值为 “0”，则意味着所有呼叫都将通过此特殊线路路由。所有其他值表示电话号码的前缀。

示例值:

示例

{
    "sip_trunks": [
        {
            "name": "trunk1",
            "sip_server_address": "192.168.0.10",
            "dnis": "90001258",
            "id": "1",
            "number_prefix": "0"
        }
    ]
}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '300' * 请求失败，因为此帐户未在SIP Connected Audio计划中注册。 * 主帐户没有sip中继配置。 * 无效参数: sip_trunks。

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '2001' 帐户不存在: {0}。