回源与转推回调格式
融合 CDN 直播服务为回源鉴权、直播转推、回源拉流功能提供 Webhook,用于获取相关信息。
回源鉴权回调格式
如果你在设置回源鉴权配置的请求中设置了 url
,声网会向这个回调 URL 发送请求,请求中会使用以下参数:
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
host | String | 是 | 推流或者播流域名。 |
entryPoint | String | 是 | 发布点。 |
streamName | String | 是 | 流名称。 |
cdnIp | String | 否 | CDN 节点的 IP 地址。 |
clientIp | String | 否 | 客户端的 IP 地址。 |
token | String | 否 | 鉴权信息。 |
requestId | String | 否 | 请求 ID。 |
你需要按照以下标准返回 HTTP 状态码:
- 200:回源鉴权通过。
- 401:回源鉴权失败。
直播转推回调格式
如果你在设置转推到第三方平台配置的请求中设置了 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 响应必须满足以下要求:
- 响应内容的格式为 JSON。
- 表示请求成功的 HTTP 状态码为 200。
- 响应包体通过
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 中的信息替换:
entry_point
:替换为播流发布点。stream_name
:替换为流名称。
你返回的 HTTP 响应必须满足以下要求:
- 响应内容的格式为 JSON。
- 表示请求成功的 HTTP 状态码为 200。
- 响应包体通过
url
字段返回源站地址,示例如下:JSON{
"url": "rtmp://cdna.example.com/live/testedge"
}