狀態碼表
阿新 • • 發佈：2018-05-04
狀態碼表提供使用融雲 SDK 及 Server API 接口時，可能遇上的狀態碼、原因及需要進行的處理方式。
Server API 狀態碼
HTTP 狀態碼
| code | 描述 | 詳細解釋 |
|---|---|---|
| 200 | 成功 | 成功 |
| 400 | 錯誤請求 | 該請求是無效的，詳細的錯誤信息會說明原因 |
| 401 | 未授權 | 驗證失敗，詳細的錯誤信息會說明原因 |
| 403 | 服務器拒絕請求 | 被拒絕調用，詳細的錯誤信息會說明原因 |
| 404 | 未找到 | 服務器找不到請求的地址 |
| 405 | 方法禁用 | 群容量超出上限，禁止調用 |
| 429 | 太多的請求 | 超出了調用頻率限制，詳細的錯誤信息會說明原因 |
| 500 | 服務器內部錯誤 | 服務器內部出錯了，請聯系我們盡快解決問題 |
| 504 | 網關超時 | 服務器在運行，本次請求響應超時，請稍後重試 |
業務返回碼
| code | 描述 | 詳細解釋 | HTTP 狀態碼 |
|---|---|---|---|
| 404 | 未找到 | 服務器找不到請求的地址 | 404 |
| 1000 | 服務內部錯誤 | 服務器端內部邏輯錯誤,請稍後重試 | 500 |
| 1001 | App Secret 錯誤 | App Key 與 App Secret 不匹配 | 401 |
| 1002 | 參數錯誤 | 參數錯誤，詳細的描述信息會說明 | 400 |
| 1003 | 無 POST 數據 | 沒有 POST 任何數據 | 400 |
| 1004 | 驗證簽名錯誤 | 驗證簽名錯誤 | 401 |
| 1005 | 參數長度超限 | 參數長度超限，詳細的描述信息會說明 | 400 |
| 1006 | App 被鎖定或刪除 | App 被鎖定或刪除 | 401 |
| 1007 | 被限制調用 | 該方法被限制調用，詳細的描述信息會說明 | 401 |
| 1008 | 調用頻率超限 | 調用頻率超限，詳細的描述信息會說明，廣播消息未開通時也會返回此狀態碼。 | 429 |
| 1009 | 服務未開通 | 未開通該服務，請到開發者管理後臺開通或提交工單申請。 | 430 |
| 1015 | 刪除的數據不存在 | 要刪除的保活聊天室 ID 不存在。 | 200 |
| 1016 | 設置保活聊天室個數超限 | 設置的保活聊天室個數超限。 | 403 |
| 1050 | 內部服務超時 | 內部服務響應超時 | 504 |
| 2007 | 測試用戶數量超限 | 測試用戶數量超限 | 403 |
Android、iOS 狀態碼
下面列舉了 SDK 使用過程中，可能遇上的錯誤碼、原因以及需要進行的處理。
| code | 原因 |
|---|---|
| -3 | 參數錯誤（Android 平臺）。 |
| -2 | IPC 進程意外終止（Android 平臺）。 |
| 405 | 已被對方加入黑名單。 |
| 20604 | 發送消息頻率過高， 1 秒鐘最多只允許發送 5 條消息。 |
| 21406 | 不在該討論組中。 |
| 22406 | 不在該群組中。 |
| 22408 | 在群組中已被禁言。 |
| 23406 | 不在該聊天室中。 |
| 23408 | 在該聊天室中已被禁言。 |
| 23409 | 已被踢出並禁止加入聊天室。 |
| 23410 | 聊天室不存在。 |
| 23412 | 聊天室接口參數無效。 |
| 23414 | 聊天室雲存儲業務未開通。 |
| 24012 | 通話鑒權失敗。 |
| 24014 | 實時音視頻功能未開啟。 |
| 24016 | 實時音視頻功能已關閉。 |
| 25101 | 消息撤回時，參數錯誤。 |
| 29106 | 未關註此公眾號。 |
| 29201 | 無效的公眾號。(由會話類型和 Id 所標識的公眾號會話是無效的)。 |
| 30001 | 當前連接不可用（連接已經被釋放）。建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 30002 | 當前連接不可用。建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 30003 | 消息響應超時。 |
| 30004 | 導航 HTTP 發送失敗。如果是偶爾出現此錯誤，SDK 會做好自動重連，開發者無須處理。對於 iOS 平臺，如果一直連接不上，應該是您沒有設置好 ATS。ATS 默認只使用 HTTPS 協議，當 HTTP 協議被禁止時 SDK 會一直 30004 錯誤。您可以在我們 iOS 開發文檔中搜索到 ATS 設置。 |
| 30007 | 導航 HTTP 請求失敗。建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 30008 | 導航 HTTP 返回數據格式錯誤。建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 30010 | Socket 不存在，一般由於沒有 connect() 引起的。 |
| 30011 | Socket 連接被斷開，主要有兩種情況，一是用戶主動調用 disconnect 之後，Socket 被服務器斷開；二是中間路由原因等導致 Socket 斷開。 |
| 30012 | PING 失敗。建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 30013 | PING 超時。 建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 30014 | 信令發送失敗。建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 30015 | 連接過於頻繁。建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 30016 | 消息大小超限，消息體（序列化成 JSON 格式之後的內容）最大 128k bytes。 |
| 30017 | 請求內存分配失敗，可能是手機內存不夠等原因引起的。 |
| 31000 | 連接 ACK 超時。建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 31002 | App Key 錯誤。請檢查您使用的 App Key 是否正確。 |
| 31003 | 服務器當前不可用（預留）。 建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 31004 | Token 無效。Token 無效一般有以下兩種原因。一是 Token 錯誤，請您檢查客戶端初始化使用的 App Key 和您服務器獲取 Token 使用的 App Key 是否一致；二是 Token 過期，是因為您在開發者後臺設置了 Token 過期時間，您需要請求您的服務器重新獲取 Token 並再次用新的 Token 建立連接。 |
| 31006 | 連接重定向。建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 31007 | BundleID 不正確。請檢查您 App 的 BundleID 是否正確。 |
| 31008 | App Key 被封禁或已刪除。請檢查您使用的 App Key 是否正確。 |
| 31009 | 用戶被封禁。請檢查您使用的 Token 是否正確，以及對應的 UserId 是否被封禁。 |
| 31010 | 當前用戶在其他設備上登錄，此設備被踢下線 |
| 32061 | 連接被拒絕。建立連接的臨時錯誤碼，SDK 會做好自動重連，開發者無須處理。 |
| 33001 | SDK 沒有初始化，在使用 SDK 任何功能之前，必須先調用 Init。 |
| 33002 | 數據庫錯誤，請檢查您使用的 Token 和 userId 是否正確。 |
| 33003 | 開發者接口調用時傳入的參數錯誤，請檢查接口調用時傳入的參數類型和值。 |
| 33007 | 歷史消息雲存儲業務未開通。 |
| -1000 | 開發者接口調用時傳入的參數錯誤。請檢查接口調用時傳入的參數類型和值。 |
狀態碼表