截取片段

RESTful

post

https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points/{entry_point}/admin/record/standard/regions/{region}/cutting/{stream_name}

标准录制支持从单个录制文件中截取片段。

该方法从指定流的录制文件中截取片段并生成 M3U8 文件。

请求

API Key

融合 CDN 直播 RESTful API 使用 HTTP HMAC (Hash-based Message Authentication Code) 认证。

在发送 HTTP 请求时，你需要通过 HMAC-SHA256 算法生成一个签名，并在请求头部的 Authorization 字段传入签名及相关信息。详见认证方式。

路径参数

appidstringRequired

声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。

entry_pointstringRequired

发布点名称。

regionstringRequired

添加推流域名时设置的区域。

stream_namestringRequired

直播流名称。

请求 Body

application/json

startTimestringRequired

截取片段的开始时间，时间格式为 RFC3339，例如：2019-01-07T12:00:00+08:00。

endTimestringOptional

截取片段的终止时间，时间格式为 RFC3339，例如：2019-01-07T12:30:00+08:00 。该字段不能超过当前时间。如果不填，将使用最新录制文件的创建时间点。

fileNamestringRequired

生成的 M3U8 文件的名称。你需要保证该字段的唯一性。

响应

如果返回的 HTTP 状态码为 200，表示请求成功。

请求示例

cURL

Bash
curl --request post \
  --url https://api.sd-rtn.com/v1/projects/:appid/fls/entry_points/:entry_point/admin/record/standard/regions/:region/cutting/:stream_name \
  --header 'Authorization: Basic <credentials>' \
  --data '
{
  "startTime": "2019-01-07T12:00:00+08:00",
  "endTime": "2019-01-07T12:30:00+08:00",
  "fileName": "test.m3u8"
}
'

响应示例

如果返回的 HTTP 状态码为 200，表示请求成功。