2025/08/26 11:28:12

参考信息

本文提供在使用融合 CDN API 过程中，需要额外了解的 API 参考信息。

第三方云存储地区说明

使用自定义录制和自定义截图功能时，你可以通过 StorageConfig 进行录制文件和截图文件的第三方云存储配置，其中 vendor 参数（第三方云存储平台）的取值决定了 region 参数（第三方云存储地区）的取值。

本文介绍 vendor 的不同取值下，region 参数可以配置的值。

当 vendor = 1，即第三方云存储为 Amazon S3 时，region 可取如下值：

当 vendor = 2，即第三方云存储为阿里云时，region 可取如下值：

当 vendor = 3，即第三方云存储为腾讯云时，region 可取如下值：

当 vendor = 5，即第三方云存储为 Microsoft Azure 时，无需设置 region 参数，即使设置也不生效。

当 vendor = 6，即第三方云存储为谷歌云时，无需设置 region 参数，即使设置也不生效。

当 vendor = 7，即第三方云存储为华为云时，region 可取如下值：

当 vendor = 8，即第三方云存储为百度智能云时，region 可取如下值：

如果你在设置回源鉴权配置的请求中设置了 url，声网会向这个回调 URL 发送请求，请求中会使用以下参数：

你需要按照以下标准返回 HTTP 状态码：

如果你在设置转推到第三方平台配置的请求中设置了 callbackUrl，当你向声网推流时，声网会向这个回调 URL 发送请求获取你的推流目标地址。声网发送的请求示例如下：

Shell
POST https://example.transfer.com/callback?entry_point={entry_point}&stream_name={stream_name} HTTP/1.1

其中 entry_point 为你的发布点名称，stream_name 为你的直播流名称。

你返回的 HTTP 响应必须满足以下要求：

响应包体通过 transferUrls 字段返回目标推流地址，示例如下：

JSON
{
    "transferUrls": [
        "rtmp://cdna.example.com/live/testedge",
        "rtmp://cdnb.example.com/live/testedge"
    ]
}

声网成功收到你的 HTTP 响应后，你的直播流将开始转推到第三方平台。

如果你在设置回源拉流配置的请求中设置了 callbackUrl，声网会在收到观众的播放请求时，向这个回调 URL 发送请求获取你的源站地址。声网发送的请求示例如下：

Shell
GET https://example.origin-site.com/entry_point={entry_point}&stream_name={stream_name} HTTP/1.1

其中以下参数会按播流 URL 中的信息替换：

你返回的 HTTP 响应必须满足以下要求：