响应说明_流媒体处理_Media Acceleration VoD-文档中心

本文档详细说明API请求的响应格式及可能返回的HTTP状态码。

响应格式

当请求成功时，服务端将返回包含persistentId的JSON响应内容：

{
    "persistentId": "<persistentId>"
}

persistentId是用于追踪任务执行的唯一标识符。您可在联系技术支持时提供此ID以便问题排查。

重要说明：persistentId仅表示请求已成功提交，不代表流媒体处理任务已完成。为了监控任务状态，建议通过配置回调接口实时获取任务状态通知。

当请求失败时，服务端将返回包含错误详情的JSON响应内容：

{
    "code": "<HTTP_RESPONSE_CODE>",
    "message": "<ERROR_MESSAGE>"
}

字段	说明
`code`	HTTP状态码（参见下方HTTP响应状态码章节）
`message`	描述流媒体处理失败原因的说明提示信息

状态码	返回消息	返回码说明
200	OK	操作执行成功
304	Not Modified	文件未修改，当前版本已是最新
401	Authorization Required	请求头中需要有Authorization
401	AK/SK Not Found	AccessKey（AK）或AccessKey Secret（SK）未找到
401	Token Invalid	请求Token错误
401	ExpireTime Is Null	ExpireTime字段为空
401	Token Format Invalid	请求Token格式错误
401	Bucket Access Denied	空间拒绝访问
401	The Persistent File Already Exists	持久化处理后的文件已经存在
404	Bucket Not Found	空间不存在
404	File Not Found	未找到请求的文件
404	bucketErrorPage	未找到请求的资源
404	Bucket Not Binding Mirror	空间未绑定镜像源
405	Token Required	需要提供Token
406	File Already Exist	文件已存在
406	File Is Busy, Please Retry Later	文件在处理中，请稍后重试
500	Internal Server Error	服务器内部错误

状态码	返回消息	返回码说明
401	Bucket Open Image Protect Function, Unable To Get Original Image	因开启原图保护禁止访问原图
401	Non-standard Type Of Op	非标准操作类型
401	Image Process Param Error	图片操作参数错误
404	Watermark Image Url Invalid	水印图片URL无效
404	WaterMark Image Not Found	水印图片未找到
579	Get WaterMark Image Fail	水印图片下载失败

状态码	返回消息	返回码说明
400	Tranfer Parameters Error	转码参数有误
401	Ops Invalid	请求中的fops无效（Ops不合法）
404	Video Persistent Progress Info Not Found	未找到视频持久化进度信息
579	Json Response	回调业务服务器响应异常