API 錯誤碼表

概述

API 請求失敗時，服務端會返回一個 JSON 格式的響應體。它可以用于定位具體錯誤原因。如：

1
{"msg":"authorization error", "code":401000002,"id":"238235e6-8160-48ed-a9b2-1309938b09a9"}

字段說明

• code：錯誤碼。具體含義見 API 錯誤碼表。
• msg：錯誤的簡單描述。
• id：fss為該請求生成的唯一 ID。

API 錯誤碼表

如遇 5xx 錯誤，請反饋給售后或您的商務經理。

HTTP 狀態(tài)碼	返回代碼	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