接口功能介绍
在视频分片上传完毕后，可通过本接口完成点播模式下的视频上传流程。
接口约束
本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。
URI
POST /video/create/complete
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| videoId | 是 | String | 视频ID | 34c71dba-f280-4f5e-a05f-f4daed837fef | |
| etags | 是 | Array of Objects | 每个分片eTag信息的列表。必须将所有分片的eTag信息都传入。 | etags |
表 etags
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| partNumber | 是 | Integer | 分片编号，从 1 开始。 | 1 | |
| eTag | 是 | String | eTag字符串，由上传视频分片成功后的Response的eTag头部取得。 | f2a7e5e125df0be8e9098df369b32486-1 |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 本次请求的结果码。 | 0 | |
| message | 是 | String | 错误文本信息，创建成功时，为空字符串。 | "" | |
| data | 是 | Object | 返回数据。 | data |
表data
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| videoId | 是 | String | 视频的 id，仅可用在 完成上传视频接口以及 删除视频接口。 |
34c71dba-f280-4f5e-a05f-f4daed837fef | |
| videoUrl | 是 | String | 视频的 url。 | http://example.gdoss.xstore.ctyun.cn/bucket/uploadPart?partNum=1signature=xxxxxx |
请求示例
{
"videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef",
"etags": [
{
"partNumber": 1,
"eTag": "f2a7e5e125df0be8e9098df369b32486-1"
}, {
"partNumber": 2,
"eTag": "f2a7e5e125df0be8e9098df369b32486-2"
}
]
}
响应示例
{
"code": 0,
"message": "",
"data" : {
"videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef",
"videoUrl": "http://example.gdoss.xstore.ctyun.cn/bucket/xxxx.mp4"
}
}
状态码
| Http 状态码 | 状态码信息 | 状态码描述 |
|---|---|---|
| 0 | 表示业务成功 | 表示业务成功 |
| 400 | 请求参数有误 | 请求参数有误 |
| 403 | 用户鉴权失败，用户无操作权限 | 用户鉴权失败，用户无操作权限 |
| 404 | 请求的资源不存在，输入错误的URL | 请求的资源不存在，输入错误的URL |
| 500 | 业务执行异常 | 业务执行异常 |
错误码
OpenAPI错误码请参考 错误码说明。
