发布点用于对直播流进行分组。你可以针对一个发布点配置录制、转码、截图等功能,这些配置适用于这个发布点下的所有流。
声网提供一个默认发布点 live
,你可以直接使用。
增加一个发布点。
增加发布点时需要指定你的声网项目的 App ID。
POST https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points?id={entry_point}
appid
:String 型,必填。声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。
id
:String 型,必填。要增加的发布点名称。
如果返回的 HTTP 状态码为 201,表示请求成功。
如果返回的 HTTP 状态码非 201,表示请求失败。你可以参考 HTTP 状态码了解可能的原因。
请求行
POST https://api.sd-rtn.com/v1/projects/{your_appid}/fls/entry_points?id=live2 HTTP/1.1
响应行
HTTP/1.1 201 Created
删除一个发布点。默认的发布点 live
不可删除。
DELETE https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points/{entry_point}
参数 | 类型 | 描述 |
---|---|---|
appid |
String | 必填。要删除的在声网控制台获取的 App ID。 |
entry_point |
String | 必填。要删除的发布点名称。 |
如果返回的 HTTP 状态码为 200,表示请求成功。
如果返回的 HTTP 状态码非 200,表示请求失败。你可以参考 HTTP 状态码了解可能的原因。
请求行
DELETE https://api.sd-rtn.com/v1/projects/{your_appid}/fls/entry_points/live2 HTTP/1.1
响应行
HTTP/1.1 200 OK
获取一个声网项目下所有的发布点。
GET https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points
appid
:String 型,必填。你的声网项目的 App ID。
如果返回的 HTTP 状态码为 200,表示请求成功,响应包体中包含以下字段:
entryPointList
:JSON Array 型,发布点列表。一个发布点对应一个 JSON Object,包含以下字段:
字段 | 类型 | 描述 |
---|---|---|
name |
String | 发布点名称。 |
如果返回的 HTTP 状态码非 200,表示请求失败。你可以参考 HTTP 状态码了解可能的原因。
请求行
GET https://api.sd-rtn.com/v1/projects/{your_appid}/fls/entry_points HTTP/1.1
响应行
HTTP/1.1 200 OK
响应 body
{
"entryPointList": [
{
"name": "live"
}
]
}
状态码 | 描述 |
---|---|
200 | 请求成功。 |
201 | 资源(发布点)创建成功。 |
400 | appid 或者 entry_point 为空。 |
401 | 未经授权的(客户 ID/客户密钥匹配错误)。 |
404 | 服务器无法根据请求找到资源,即请求的发布点不存在或者请求的 URI 路径非法。 |
500 | 服务器内部错误,无法完成请求。 |
504 | 服务器内部错误,充当网关或代理的服务器未从远端服务器获取请求。 |