2. 错误响应¶
2.1. 描述¶
当调用接口失败时，NOS富媒体服务将返回错误码和详细错误信息，以帮助用户定位问题。返回格式支持”json”和”xml”，通过在header中配置”X-Nos-Entity-Type”即可。
2.2. 格式¶
1 <Error> 2 <Code>${ErrorCode}</Code> 3 <Message>${Message}</Message> 4 <Resource>${resource}</Resource> 5 <RequestId>${requestId}</RequestId> 6 </Error>
2.3. 元素说明¶
| 名称 | 描述 |
|---|---|
| Code | 富媒体服务返回给用户的错误码 |
| Message | 富媒体服务给出的详细错误信息 |
| Resource | 请求资源信息 |
| Resource | 用以标识错误请求的唯一UUID，在无法解决问题时候，可以使用此错误ID发送给图片处理服务的工程师去定位错误的原因 |
2.4. 错误码¶
| ErrorCode | Http Code | Description |
|---|---|---|
| NotAnImage | 400 | 图片操作请求对象不是图片 |
| ImageFormatNotSupported | 400 | 图片操作原图或type指定格式不支持 |
| VideoNotSupported | 415 | 非法视频文件 |
| VideoParamInvalid | 400 | 视频操作参数非法 |
| VideoInternalError | 500 | 视频转码内部错误 |
| DirectRefusedRequest | 503 | 目录繁忙（当前队列已满，插入队列失败） |
| WaitRefusedRequest | 503 | 当前任务队列中任务过多，从队列中取出时发现该任务等待处理已超时 |
| ProcessTimeOut | 503 | 数据处理超时，常由文件过大引发 |
| InvalidArgument | 400 | 参数非法 |
| InvalidChainOperator | 400 | 链式处理非法，包括未指定操作，链式操作非法 |
| ReqPathTooLong | 400 | 请求路径太长 |
| QueryStrTooLong | 400 | queryStr太长（超过1024） |
| NotAnObjectPath | 400 | 请求路径非object路径 |
| OperatorForbid | 403 | 操作不允许 |
| NotFound | 403 | 请求资源不存在 |
| InternalError | 500 | 内部错误 |
| UnsupportedMediaType | 415 | 请求媒体文件格式不支持 |
| AudioNotSupported | 415 | 不支持的音频格式 |
| AudioInternalError | 500 | 音频转码内部错误 |
| AudioInvalidArgument | 400 | 非法音频转码参数 |
| ServerBusy | 503 | 系统繁忙 |
| RequestRangeNotSatisfiable | 416 | 请求Range非法 |
| OtherError | 500 | 其它错误 |
| BadRequest | 400 | 请求错误 |
| NotModified | 304 | NotModified |
| LogoEdgeSizeOutOfLimit | 400 | logo水印图片超出限制长度 |
| WEBPEdgeSizeOutOfLimit | 400 | webp图片边长超出大小限制–webp图片类型支持的长宽不得超过16384 |
| InvalidPadColor | 400 | pad颜色非法 |
| LogoNotAnImage | 400 | logo水印图片不是图片 |
| LogoNotFound | 404 | logo水印图片不存在 |
| UnSupportedLogoType | 400 | 不支持的logo格式，如logo图片是gif |
| ImageNotFound | 404 | 图片未找到，主要为gif合成时，指定图片不存在 |
| GIFOptionInvalid | 400 | gif合成参数文件非法 |