API 請求失敗時，服務(wù)端會返回一個 JSON 格式的響應(yīng)體。它可以用于定位具體錯誤原因。如：
1{"msg":"authorization error", "code":401000002,"id":"238235e6-8160-48ed-a9b2-1309938b09a9"}
字段說明
code：錯誤碼。具體含義見 API 錯誤碼表。msg：錯誤的簡單描述。id：fss為該請求生成的唯一 ID。如遇 5xx 錯誤，請反饋給售后或您的商務(wù)經(jīng)理。
| HTTP 狀態(tài)碼 | 返回代碼 | msg | 含義 |
|---|---|---|---|
| 400 | 400000001 | file size error | 文件大小異常 |
| 400 | 400000002 | file or folder already exists | 文件或目錄已經(jīng)存在 |
| 400 | 400000003 | wrong uri | uri錯誤 |
| 400 | 400000004 | wrong bucket auth | 桶認(rèn)證錯誤 |
| 400 | 400000005 | bucket must have an administrator user | 必須使用管理員賬號 |
| 400 | 400000006 | bucket not allowed delete administrator user | 未授權(quán)刪除管理員賬號 |
| 400 | 400000007 | bucket log to save day error | 日志保留天數(shù)異常 |
| 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 | 當(dāng)前目錄還存在文件 |
| 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參數(shù)值錯誤 |
| 400 | 400000017 | wrong x-west-list-iter | x-west-list-iter參數(shù)值錯誤 |
| 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 | 圖片旋轉(zhuǎn)失敗 |
| 400 | 400100008 | wrong img flip | 圖片鏡面翻轉(zhuǎn)失敗 |
| 400 | 400100009 | wrong img sharp | 圖片銳化失敗 |
| 400 | 400100010 | wrong img gauss | 圖片高斯模糊失敗 |
| 400 | 400100011 | wrong img border | 圖片邊框添加失敗 |
| 400 | 400100012 | wrong img canvas | 圖片畫布設(shè)置失敗 |
| 400 | 400100013 | wrong img set | 圖片設(shè)置失敗 |
| 400 | 400100014 | wrong img save | 圖片保存失敗 |
| 400 | 400100015 | wrong img param | 圖片參數(shù)異常 |
| 401 | 401000001 | unknown realm in authorization header | 授權(quán)請求頭中存在未知域 |
| 401 | 401000002 | authorization error | 認(rèn)證失敗 |
| 401 | 401000004 | invalid date value in header | 不合法的日期格式 |
| 403 | 403000001 | authorization has expired | 認(rèn)證已過期 |
| 403 | 403000002 | Forbidden | Forbidden |
| 403 | 403000003 | has no permission to operation | 沒有操作權(quán)限 |
| 403 | 403000004 | has no permission to read | 沒有讀權(quán)限 |
| 403 | 403000005 | bucket forbidden | 桶禁止訪問 |
| 403 | 403100001 | no permission | 文件存在密碼，驗(yàn)證失敗 |
| 403 | 403100002 | no permission http read | referer為空，驗(yàn)證失敗 |
| 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驗(yàn)證失敗 |
| 403 | 403100008 | no permission http read | 防盜鏈token驗(yàn)證失敗 |
| 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 |