ZIM error codes
Warning
The newly released In-app Chat 2.0.0 has been upgraded considerably (for detailed changes, see Release notes). If the version of the SDK you are using is earlier than 2.0.0, for its error codes, see Error codes for In-app Chat 1.x.x. For a better development experience, we recommend you use the latest version of SDK.
Overview
This document provides possible causes and solutions for the network errors or the errors that you may encounter when running the latest version of SDK.
If the errorCode field exists in the result after the method is called, which indicates that an error occurs. And the code will be like this:
Untitled
- (void)zim:(ZIM *)zim errorInfo:(ZIMError *)errorInfo{
NSLog(@"errorCode%lu,%@",(unsigned long)errorInfo.code,errorInfo.message);
}
1
General errors
| Return code | Possible cause and solutions |
|---|---|
| 0 | Request execution successful. |
| 1 | Request execution failed. |
| 6000001 | The parameter is invalid. Please check the parameter. |
| 6000002 | The SDK is not initialized. Please initialize the SDK first before calling methods. |
| 6000003 | The AppID is invalid or has expired. Please check the AppID or contact ZEGOCLOUD Technical Support. |
| 6000004 | Requests have exceeded the SDK's upper limit. |
| 6000005 | Requests have exceeded the backend server's upper limit. |
| 6000006 | The Switch server reported an error, because requests have exceeded the backend server's upper limit. Please contact ZEGOCLOUD Technical Support. |
| 6000007 | Internal server error. Please contact ZEGOCLOUD Technical Support. |
| 6000008 | Internal database error. Please contact ZEGOCLOUD Technical Support. |
| 6000009 | Disconnected while sending the request. Please try reconnecting. |
| 6000010 | Failed to upload logs. Please contact ZEGOCLOUD Technical Support. |
| 6000011 | The user doesn't exist. Please check whether the user ID. |
| 6000012 | The operation of user information reaches the limit. Please confirm:
|
| 6000013 | The current billing plan does not support this operation. Please confirm your plan permissions |
| 6000015 | Exceed the DAU limit for your AppID. Please upgrade your plan. |
| 6000016 | Exceeded the MAU limit for your AppID. Please upgrade your plan. |
Login errors
| Return code | Possible cause and solutions |
|---|---|
| 6000101 | Login failed, because the Token is invalid or the AppID is incorrect. Please check the Token or AppID. |
| 6000102 | Login failed due to an internal error. Please contact ZEGOCLOUD Technical Support. |
| 6000103 | Token is invalid. Please call the renewToken method to renew the Token and try again. |
| 6000104 | Network error. Please check the network or contact ZEGOCLOUD Technical Support. |
| 6000106 | Token has expired. Please call the renewToken method to renew the Token and try again. |
| 6000107 | The Token you are using does not match the target Token version. Please use the correct version of the Token. |
| 6000108 | The validity period of the Token is too short. This error occurs when the valid period of the Token is shorter than 30s. Please generate a Token with a longer validity period. |
| 6000111 | You have already logged in. |
| 6000121 | You have not logged in. Please call the login method to log in first. |
| 6000123 | After the user's offline time exceeds the maximum disconnection and reconnection time, the user attempts to log in to another userID without logging out of the current userID. First call the logOut interface to log out, and then call the login interface to log in. |
| 6000124 | The userID used for offline login is different from the userID used for the last successful online login. Please use the userID of the last successful online login, or log in online. |
Message errors
| Return code | Possible cause and solutions |
|---|---|
| 6000201 | Internal error occurs while sending the message. Please upload the log and contact ZEGOCLOUD Technical Support. |
| 6000202 | Internal server error. Please upload the log first and contact ZEGOCLOUD Technical Support. |
| 6000203 | Failed to send messages due to internal error. Please upload the log and contact ZEGOCLOUD Technical Support. |
| 6000204 | The message target (user, group, room) does not exist. |
| 6000210 | File module error. Check the error message or submit the log to contact ZEGOCLOUD technical support |
| 6000211 | The rich media content file doesn't exist. Please check it first. |
| 6000212 | Failed to send rich media conetent. Please upload the log and contact ZEGOCLOUD Technical Support. |
| 6000213 | Unsupported image/audio/video format. Please check the format first. For more details, refer to the Message types. |
| 6000214 | File size error. Please check the size first. For more about the size limit, refer to the Message types. |
| 6000215 | Audio duration error. Please check the duration first. For more about the duration limit, refer to the Message types. |
| 6000216 | The file does not have the correct read permissions. |
| 6000217 | A common error message for file download failure. Please upload the log first and contact ZEGOCLOUD technical support team for processing. |
| 6000218 | The file size exceeds the upper limit, causing the download to fail. The upper limit of file size is 200 MB by default. If you need to adjust it, please contact ZEGOCLOUD technical support team. |
| 6000219 | The URL of the file is invalid, causing the download to fail. Please verify that the URL is valid. |
| 6000220 | The download failed due to request failure. Please verify that the URL is valid. |
| 6000221 | Failed to pass the content moderation. Please check the message content. |
| 6000222 | Content moderation failed. Please upload the logs first and contact ZEGOCLOUD Technical Support. |
| 6000230 | Message sending failed due to developer business side review. No processing required. |
| 6000231 | Failed to send message due to being banned. Wait for the ban to be lifted or the ban period to expire before sending a message. |
| 6000240 | An error occurred in the import and export interface. Please confirm whether the corresponding DB file exists. |
| 6000241 | Import or export message operation is in progress. Do not execute it repeatedly. |
| 6000242 | Only the current user's data can be imported. Please confirm whether the imported message data belongs to the current user. |
| 6000243 | Error exporting message. Please provide logs to ZEGOCLOUD technical support for troubleshooting. |
| 6000244 | Error importing message. Please provide logs to ZEGOCLOUD technical support for troubleshooting. |
| 6000245 | Parsing error after importing message. Please provide logs to ZEGOCLOUD technical support for troubleshooting. |
Call invitation errors
| Return code | Possible cause and solutions |
|---|---|
| 6000270 | Call invitation failed. Please upload the log and contact ZEGOCLOUD Technical Support. |
| 6000271 | Failed to cancel the call invitation. The invitee has already accepted a call invitation. |
| 6000272 | Failed to initiate outbound calls, because the number of invitees has exceeded the limit or backend error occurs. Please check the number of invitees (upper limit: 9). Or contact ZEGOCLOUD Technical Support. |
| 6000273 | The call invitation was canceled by the initiator. |
| 6000274 | The call invitation was accepted or rejected by an uninvited user. Please check whether the responding user is the target user. |
| 6000275 | The callID already exists. |
| 6000276 | The callID does not exist or has expired while canceling/accepting/rejecting the call invitation. Please check whether the callID exists or has expired. |
| 6000281 | All invitees were not registered when the call invitation was initiated. |
| 6000283 | The device that called the callJoin interface is already calling in advanced mode and is the primary device. |
| 6000286 | A normal mode call ID was passed in when calling advanced mode interfaces such as callJoin, callQuit, callEnd, callingInvite, etc. Please check the callID and its mode. |
Room errors
| Return code | Possible cause and solutions |
|---|---|
| 6000301 | Room ID does not exist. Please check the Room ID. |
| 6000302 | Operation failed due to internal error. Please upload the log and contact ZEGOCLOUD Technical Support. |
| 6000303 | Failed to create room due to internal error. Please upload the log and contact ZEGOCLOUD Technical Support. |
| 6000304 | Failed to join the room because the room does not exist. Please check whether the room ID exists. |
| 6000306 | Failed to leave the room because the room does not exist. Please check whether the room ID exists or contact ZEGOCLOUD Technical Support. |
| 6000320 | The user is already in the room. Please check it. |
| 6000321 | The user does not in the room. Please check whether the user is in the room. |
| 6000322 | The room corresponding to the roomID does not exist when calling the joinRoom method. Please check whether the room ID exists. |
| 6000323 | The room corresponding to the roomID already exists when calling the createRoom method. Please do not create rooms with the same Room ID. |
| 6000324 | The number of rooms has exceeded the upper limit (20). |
| 6000325 | The number of rooms a user can join at the same time has exceeded the upper limit. By default, a user can join up to 5 rooms at a time. |
| 6000326 | Repeatedly try the createRoom, joinRoom, or enterRoom interfaces multiple times, or perform an action on a room that is being connected. Please wait for onRoomStateChanged to return the room connection result before operating. |
| 6000330 | Room property error. |
| 6000331 | Failed to operate room properties. Please try again. |
| 6000332 | Failed to operate some room properties. Please try again. |
| 6000333 | Failed to search the room property. Please try again. |
| 6000334 | The number of the room property has exceeded the upper limit. A maximum of 10 properties can be set per room. |
| 6000335 | The length of the room property (key) has exceeded the limit. The default length of the key is 16. |
| 6000336 | The length of the room property (value) has exceeded the limit. The default length of the value is 1024. |
| 6000337 | The total length of the room property (value) has exceeded the limit. The limit of the total length was configured by the backend. Please contact ZEGOCLOUD Technical Support to check. |
| 6000350 | User attribute error in room. Please upload logs first and contact ZEGOCLOUD technical support team for processing. |
| 6000351 | The total size of user attributes in the room exceeds the limit. For a single user, the total length of all Key-Value is up to 144 bytes, with a maximum of 30 pairs. |
| 6000352 | The Key size of the user attribute in the room exceeds the limit. The maximum length of a single Key is 8 bytes. |
| 6000353 | The Value size of the user attribute in the room exceeds the limit. The maximum length of a single Value is 64 bytes. |
| 6000354 | In the same room, user attributes are added/modified too frequently. During the current time period, everyone in the room can perform new/modified operations, and the total cannot exceed 20 times/10s. |
| 6000355 | User attributes are queried too frequently in the same room. In the current time period, everyone in the room can perform query operations, and the cumulative number cannot exceed 1000 times/10s. |
| 6000356 | This user queries too frequently in the same room. Within the current time period, a single user in the room can perform query operations no more than 5 times/30s. |
| 6000357 | The number of users who can set attributes in the same room exceeds the upper limit. User attributes can be set for up to 500 users in the same room. |
Offline notification errors
| Return code | Possible cause and solutions |
|---|---|
| 6000401 | The ID is invalid. Please check whether the ID exists. |
Group errors
| Return code | Possible cause and solutions |
|---|---|
| 6000501 | Operation failed. Please upload the log and contact ZEGOCLOUD Technical Support. |
| 6000502 | Operation failed due to internal error. Please upload the log and contact ZEGOCLOUD Technical Support. |
| 6000503 | Failed to create the group. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000504 | Unfroup failed. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000505 | Failed to join the group. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000506 | Failed to leave the group. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000507 | Failed to remove the member from the group. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000508 | Failed to add members to the group. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000509 | Failed to change the group owner. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000510 | Failed to operate the group information. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000511 | Failed to search the group information. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000512 | Failed to operate the group property. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000513 | Failed to query the group property. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000514 | Failed to update the group member info. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000515 | Failed to query the group member info. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000516 | Failed to query the group list. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000517 | Failed to query the group member list. Please try again or contact ZEGOCLOUD Technical Support. |
| 6000521 | The member does not in the group. |
| 6000522 | The member is already in the group. |
| 6000523 | The group does not exist. Please check whether the group exists before calling related methods. |
| 6000524 | The group already exists. |
| 6000525 | The number of group members has exceeded the upper limit. |
| 6000526 | The group property does not exist. |
| 6000527 | Create a group using the group ID that has been destroyed. Please use a different ID. |
| 6000531 | The number of group properties has exceeded the upper limit (10). |
| 6000532 | The length of the group property (key) has exceeded the limit. The default length of the key is 16. |
| 6000533 | The length of the group property (value) has exceeded the limit. The default length of the value is 1024. |
| 6000541 | You don't have permission to call group-related methods. |
| 6000542 | This group prohibits users from outside the group from actively joining. |
| 6000543 | Call the joinGroup interface to directly join the group and report an error. Please call sendGroupJoinApplication to initiate a group application and wait for review by the group owner or administrator. |
| 6000544 | Call the inviteUsersIntoGroup interface to invite external users to join the group. Since the beInviteMode of the group is Auth (1), the user does not directly join the group. Please wait for the target user to agree or refuse to join the group. |
Session errors
| Return code | Possible cause and solutions |
|---|---|
| 6000601 | Session failed. Please upload the log and contact ZEGOCLOUD Technical Support. |
| 6000602 | Operation failed due to internal error. Please upload the log and contact the ZEGOCLOUD technical support team. |
| 6000603 | The session does not exist. Please check the session. |
| 6000604 | The number of session pin lists exceeds the upper limit. If you need to increase the upper limit, please contact ZEGO technical support. |
Message receipt erros
| Return code | Possible cause and solutions |
|---|---|
| 6000277 | Failed to set message receipt as read. Please confirm whether the parameters for setting the message receipt read are correct. |
| 6000282 | Call the sendMessageReceiptsRead interface to set more than 10 messages as read at one time. Please reduce the number of incoming messages to less than 10. |
Message withdrawal errors
| Return code | Possible cause and solutions |
|---|---|
| 6000278 | The user wants to withdraw a message but the time limit for withdrawal has expired. Please confirm whether the withdrawn message has exceeded the time limit. |
| 6000279 | The user wants to withdraw a message but it has already been withdrawn. Please confirm whether the withdrawal is repeated. |
Message reaction errors
| Return code | Possible cause and solutions |
|---|---|
| 6000280 | Indicates that when a user expresses or deletes a position on a certain key in a message, the key has already been expressed or deleted by the user. Developers can provide pop-up prompts or do not perform special processing. |
Blacklist errors
| Return code | Possible cause and solutions |
|---|---|
| 6000284 | Unable to send messages because the recipient of the message has been blocked. Process client UI performance according to normal blacklist logic. |
| 6000804 | When you block a user, the user is already on the blacklist. No need to block people again. |
| 6000805 | Blocking yourself is not supported. Please check whether the userID passed is correct. |
| 6000806 | This user has been removed from the blacklist. Please check the blacklist relationship. |
| 6000807 | This user is not in the blacklist. Please check the blacklist relationship. |
| 6000808 | The blacklist capacity limit has been reached. Remove some blacklist members or contact ZEGOCLOUD technical support team for expansion. |
| 6000815 | Failed to block user. Please check ZIMErrorUserInfo > reason in the callback to get the specific failure reason. |
| 6000816 | Failed to remove user from blacklist. Please check ZIMErrorUserInfo > reason in the callback to get the specific failure reason. |
Friend management errors
| Return code | Possible cause and solutions |
|---|---|
| 6000801 | The number of friends has reached the upper limit (3000) and no more friends can be added. Remove some friends or contact ZEGOCLOUD technical support team for expansion. |
| 6000802 | The current user has agreed or rejected the application and cannot call the agree or reject friend application interface again. Handle client UI performance according to normal friend management logic. |
| 6000803 | The current user has agreed or rejected the application and cannot call the agree or reject friend application interface again. Handle client UI performance according to normal friend management logic. |
| 6000809 | The number of friends deleted at one time exceeds the upper limit (default is 20). Please reduce the number of incoming users. |
| 6000810 | When adding a friend or initiating a friend application, the user ID passed in is the operating user himself. Handle client UI performance according to normal friend management logic. |
| 6000811 | When adding a friend or initiating a friend application, the user ID passed in is the operating user himself. Handle client UI performance according to normal friend management logic. |
| 6000812 | When deleting friends, the user ID passed in is not the friend of the operating user. Please check whether your code complies with the friend management logic. |
| 6000813 | When deleting a friend, the user ID passed in is the operating user himself. Please check whether your code complies with the friend management logic. |
| 6000814 | The friend application has expired, and the interface for agreeing or rejecting the friend application cannot be called. Handle client UI performance according to normal friend management logic. |