API 请求失败时,服务端会返回一个 JSON 格式的响应体。它可以用于定位具体错误原因。如:
1{"msg":"authorization error", "code":401000002,"id":"238235e6-8160-48ed-a9b2-1309938b09a9"}
字段说明
code
:错误码。具体含义见 API 错误码表。msg
:错误的简单描述。id
:fss为该请求生成的唯一 ID。如遇 5xx
错误,请反馈给售后或您的商务经理。
HTTP 状态码 | 返回代码 | msg | 含义 |
---|---|---|---|
400 | 400000001 | file size error | 文件大小异常 |
400 | 400000002 | file or folder already exists | 文件或目录已经存在 |
400 | 400000003 | wrong uri | uri错误 |
400 | 400000004 | wrong bucket auth | 桶认证错误 |
400 | 400000005 | bucket must have an administrator user | 必须使用管理员账号 |
400 | 400000006 | bucket not allowed delete administrator user | 未授权删除管理员账号 |
400 | 400000007 | bucket log to save day error | 日志保留天数异常 |
400 | 400000008 | bucket naming error | 桶名异常 |
400 | 400000009 | request body too big | 访问请求体过大 |
400 | 400000010 | read body error | 读取请求体异常 |
400 | 400000011 | wrong content-md5 | 错误的文件md5加密信息 |
400 | 400000012 | directory not empty | 当前目录还存在文件 |
400 | 400000013 | wrong meta operation mode | 错误的meta操作类型 |
400 | 400000014 | bucket quota error | 桶配额异常 |
400 | 400000015 | bucket not enough space | 没有足够的空间 |
400 | 400000016 | wrong x-west-multi-stage | x-west-multi-stage参数值错误 |
400 | 400000017 | wrong x-west-list-iter | x-west-list-iter参数值错误 |
400 | 400000018 | wrong expire time | 过期时间异常 |
400 | 400000019 | wrong index | 索引异常 |
400 | 400000020 | wrong object type | 对象类型异常 |
400 | 400000021 | file not upload all block | 大文件上传为上传完成 |
400 | 400000022 | violation of access policy | 违反访问策略 |
400 | 400100001 | wrong img load | 图片加载失败 |
400 | 400100002 | wrong img exifset | exif属性有误 |
400 | 400100003 | wrong img getinfo | 图片信息获取失败 |
400 | 400100004 | wrong img zoom | 图片缩放失败 |
400 | 400100005 | wrong img crop | 图片裁减失败 |
400 | 400100006 | wrong img water | 图片生成水印失败 |
400 | 400100007 | wrong img rotate | 图片旋转失败 |
400 | 400100008 | wrong img flip | 图片镜面翻转失败 |
400 | 400100009 | wrong img sharp | 图片锐化失败 |
400 | 400100010 | wrong img gauss | 图片高斯模糊失败 |
400 | 400100011 | wrong img border | 图片边框添加失败 |
400 | 400100012 | wrong img canvas | 图片画布设置失败 |
400 | 400100013 | wrong img set | 图片设置失败 |
400 | 400100014 | wrong img save | 图片保存失败 |
400 | 400100015 | wrong img param | 图片参数异常 |
401 | 401000001 | unknown realm in authorization header | 授权请求头中存在未知域 |
401 | 401000002 | authorization error | 认证失败 |
401 | 401000004 | invalid date value in header | 不合法的日期格式 |
403 | 403000001 | authorization has expired | 认证已过期 |
403 | 403000002 | Forbidden | Forbidden |
403 | 403000003 | has no permission to operation | 没有操作权限 |
403 | 403000004 | has no permission to read | 没有读权限 |
403 | 403000005 | bucket forbidden | 桶禁止访问 |
403 | 403100001 | no permission | 文件存在密码,验证失败 |
403 | 403100002 | no permission http read | referer为空,验证失败 |
403 | 403100003 | no permission http read | referer黑名单匹配成功 |
403 | 403100004 | no permission http read | referer白名单匹配失败 |
403 | 403100005 | no permission http read | agent黑名单匹配成功 |
403 | 403100006 | no permission http read | agent白名单匹配失败 |
403 | 403100007 | no permission http read | 防盗链token验证失败 |
403 | 403100008 | no permission http read | 防盗链token验证失败 |
404 | 404000001 | file or folder not found | 文件或目录未找到 |
404 | 404000002 | bucket not found | 桶不存在 |
404 | 404000003 | big file not upload sucess | 大文件未上传完毕无法访问 |
405 | 405000001 | Method Not Allowed | 被拒绝的请求方式 |
501 | 501000001 | Not implemented | |
500 | 500000001 | Internal Server Error | |
500 | 500000002 | async add task err |