该接口提供对存储在云平台的视频资源进行截图操作。
POST /fops
HOST: <MgrDomain>
Authorization: <AccessToken>
| 参数 | 必填 | 描述 |
|---|---|---|
| Host | 是 | 管理域名，可在用户管理界面获取 |
| Authorization | 是 | 管理凭证 |
请求参数以如下格式组织，作为请求内容提交：
bucket=<Urlsafe_Base64_Encoded_Bucket>&key=<Urlsafe_Base64_Encoded_Key>&fops=<Urlsafe_Base64_Encoded_Fops>¬ifyURL=<Urlsafe_Base64_Encoded_PersistentNotifyUrl>&force=<Force>&separate=<Separate>
| 参数 | 必填 | 描述 |
|---|---|---|
| bucket | 是 | 空间名 |
| key | 是 | 文件名 |
| fops | 是 | 处理参数列表，参数含义请参见视频截图Ops参数格式；支持同时请求多个处理，参数列表之间用 ; 分隔。 |
| notifyURL | 否 | 处理结果通知接收URL，需要使用URL安全的Base64编码，请参考通知数据内容说明。 |
| force | 否 | 是否强制执行数据处理。支持设置以下数值：
0：指定的数据处理结果如果存在，返回文件已存在，不进行处理，避免重复处理浪费资源 1：强制执行数据处理并覆盖已有文件 默认缺省为0 |
| separate | 否 | 处理是否分开通知。支持设置以下数值：
0：表示所有转码指令执行完后再一次性通知notifyURL 1：表示每个转码指令执行完后都通知notifyURL 默认缺省为0 |
fops参数示例
视频截图:
fops=Urlsafe_Base64_Encode(vframe/jpg/offset/10;vframe/jpg/offset/15)
如果请求成功，则返回如下内容的Json串:
{ "persistentId": <persistentId> }
| 字段名 | 必填 | 描述 |
|---|---|---|
| persistentId | 是 | 上传预处理或者触发持久化处理的进程ID |
如果请求失败，则返回如下内容的Json字符串：
{
"code": "<httpCode int>",
"message": "<errMsg string>"
}
| 字段名 | 必填 | 描述 |
|---|---|---|
| code | 是 | HTTP请求响应码，参见HTTP响应状态码<返回码> |
| message | 是 | 音视频处理失败的提示信息 |
curl -v -X POST -d"bucket=aW1hZ2Vz&key=bGVodS5tcDQ==&fops=dmZyYW1lL2pwZy9vZmZzZXQvMTA=&force=1&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fops"