该接口提供在云存储平台上处理图片,并将处理结果保存下来。
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,请参考通知数据内容说明。 |
force | 否 | 强制执行数据处理。当服务端发现fops指定的数据处理结果已经存在,那就认为已经处理成功,避免重复处理浪费资源。加上本字段并设为1,则可强制执行数据处理并覆盖原结果。默认值为0。 |
separate | 否 | 转码是否分开通知选项。设置1和0作为选项码:
1:表示每个转码指令执行完后都通知notifyURL 0:表示所有转码指令执行完后再一次性通知notifyURL 默认值为0 |
fops参数示例
fops=Urlsafe_Base64_Encode(imageMogr2/jpg/crop/100x|saveas/dGVzdDoxLmpwZw==;watermark/jpg/mode/1/image/aHR0cDovL2ltZzEudG91eGlhbmcuY24vdXBsb2Fkcy8yMDEyMDUwOS8wOS0wMTQzNThfOTUzLmpwZw|saveas/dGVzdDoyLmpwZw==)
如果请求成功,则返回如下内容的Json
串:
{ "persistentId": <persistentId> }
字段名 | 必填 | 描述 |
---|---|---|
persistentId | 是 | 上传预处理或者触发持久化处理的进程ID |
如果请求失败,则返回如下内容的Json字符串:
{
"code": <httpCode int>,
"message": "<errMsg string>",
}
字段名 | 必填 | 描述 |
---|---|---|
code | 是 | HTTP请求响应码,参见HTTP响应状态码<返回码> |
message | 是 | 音视频处理失败的提示信息 |
curl -v -X POST -d 'bucket=aW1hZ2Vz&key=YWZkZGQucG5n&fops=aW1hZ2VNb2dyMi9wbmcvY3JvcC8xMDB4fHNhdmVhcy9hVzFoWjJWek9qRXVjRzVu&force=1&separate=0' -H 'Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:ODE0MTk1MjVjYTZlMDA1OTgzNjc5ZTBlZDUyYjg3ZjAzMjY2ODFmNw==' --url http://mgrDomain/fops