获取云端旁路转推资源
更新时间：2023-05-30
接口描述
本接口用于获取云端旁路转推资源。
旁路转推，是指将实时音视频流以 rtmp 等协议转推到直播等服务，旁路转推也可简称转推。
在启动转推前，必须先调用获取云端旁路转推资源接口，该接口会返回一个 resourceId，在启动转推时需要携带该 resourceId。
- resourceId 存在有效期（5分钟），需要在有效期内调用启动转推接口。
- 一个 resourceId 仅可用于一次启动转推的请求。
请求结构
GET /v1/livestreamingBypass/resourceid/acquire?appId={appId} HTTP/1.1请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| appId | String | 是 | 应用ID |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| resourceId | String | 资源ID |
| maxValidTime | Long | UNIX时间戳，单位毫秒，表示资源的最大有效时间戳，等于申请时间 + 5 分钟。 获得 resourceId 后，必须在最大有效时间内调用 start 接口开始转推，超时后需要重新请求一个resourceId。 |
请求示例
GET /v1/livestreamingBypass/resourceid/acquire?appId=testapp HTTP/1.1
host: rtc.baidubce.com
content-type: application/json
authorization: {bce-authorization-string}
x-bce-request-id: {bce-request-id}响应示例
HTTP/1.1 200 OK
x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
date: Mon, 05 Sep 2022 03:25:43 GMT
transfer-encoding: chunked
content-type: application/json;charset=UTF-8
cache-control: no-cache
{
"resourceId": "testResourceId",
"maxValidTime": 1682391803241
}