接口功能介绍
用户可在点播模式下通过本接口获取媒体库源视频相关视频文件集。
接口约束
本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。
URI
POST /video/files
请求体body参数
| 参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
| videoId |
是 |
String |
源视频id |
34c71dba-f280-4f5e-a05f-f4daed837fef |
|
响应参数
| 参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
| code |
是 |
Integer |
本次请求的结果码。 |
0 |
|
| message |
是 |
String |
错误文本信息，创建成功时，为空字符串。 |
"" |
|
| data |
是 |
Array of Objects |
返回数据。 |
|
data |
表 data
| 参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
| videoId |
是 |
String |
源视频id |
34c71dba-f280-4f5e-a05f-f4daed837fef |
|
| type |
是 |
String |
视频类型，包含 ORIGINAL(源视频)/MASTER_M3U8(自适应的主m3u8文件)/TRANSCODED(转码后视频)。 |
TRANSCODED |
|
| fileId |
是 |
String |
文件id |
34c71dba-f280-4f5e-a05f-f4daed837fef/100001.m3u8 |
|
| url |
是 |
String |
视频播放的url，返回数据库中当前的url，如果没有调用签名接口签名，返回的是无签名的url，如果有调用则是上一次签名的url。 |
https://example.gdoss.xstore.ctyun.cn/vod-transcoded-xxxxx/34c71dba-f280-4f5e-a05f-f4daed837fef/100001_signed.m3u8?signature=xxxxx&Expires=1111111 |
|
| transcodeTemplateId |
否 |
Long |
视频对应的转码模板id，只有源视频存在转码后的文件集才会返回。 |
100000000003 |
|
请求示例
请求体body
{
"videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef"
}
响应示例
{
"code": 0,
"message": "",
"data": [{
"videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef",
"type": "ORIGINAL",
"fileId": "34c71dba-f280-4f5e-a05f-f4daed837fef/100001.m3u8",
"url": "https://example.gdoss.xstore.ctyun.cn/vod-transcoded-xxxxx/34c71dba-f280-4f5e-a05f-f4daed837fef/100001_signed.m3u8?signature=xxxxx&Expires=1111111"
}, {
"videoId": "34c71dba-f280-4f5e-a05f-d12r4d2f12f2",
"type": "TRANSCODED",
"fileId": "34c71dba-f280-4f5e-a05f-f4daed837fef/100007.m3u8",
"transcodeTemplateId": 100000000003,
"url": "https://example.gdoss.xstore.ctyun.cn/vod-transcoded-xxxxx/34c71dba-f280-4f5e-a05f-f4daed837fef/100007_signed.m3u8?signature=xxxxx&Expires=1111111"
}
]
}
状态码
| Http 状态码 |
状态码信息 |
状态码描述 |
| 0 |
表示业务成功 |
表示业务成功 |
| 400 |
请求参数有误 |
请求参数有误 |
| 403 |
用户鉴权失败，用户无操作权限 |
用户鉴权失败，用户无操作权限 |
| 404 |
请求的资源不存在，输入错误的URL |
请求的资源不存在，输入错误的URL |
| 500 |
业务执行异常 |
业务执行异常 |
错误码
OpenAPI错误码请参考 错误码说明。
