Common Server Error Cases
The following is the information on error cases that may occur in all BACKND functions requested to the server, and the BackndReturnObject information returned when such errors occur.
statusCode and errorCode may have different error cases with the same codes.
It is recommended that you handle exceptions using 'message' after they have been handled through 'status' and errorCode.
When undergoing exception handling for 'message,' please use Contains(inclusion) instead of Equal
When handling exception by using 'message,' please use Contains(inclusion) instead of Equal.
When the call/response fails because the network is temporarily unstable
statusCode : 400
errorCode : HttpRequestExceptionError getting response stream(ReadDone2): ReceiveFailure
Exception handling provider method: IsClientRequestFailError
When the device information cannot be found
statusCode : 400
errorCode : UndefinedParameterExceptionWhen the Google hash keys of the client(game) and the server(BACKND Console) do not match in an Android OS environment
statusCode : 401
errorCode : BadUnauthorizedExceptionWhen the user's Access Token is wrong or expired(upon login) \<Refer to the link>
statusCode : 401
errorCode : BadUnauthorizedExceptionOnly applies to Player.CustomSignIn, Player.CustomSignUp, Player.SocialMediaSignIn, Player.AutoSignIn, and Player. RefreshTheBacknd.Token methods.
Exception handling provider method: IsBadAccessTokenErrorWhen the user's Access Token is wrong or expired(upon calling functions other than login)
statusCode : 401
errorCode : BadUnauthorizedExceptionException handling provider method: IsBadAccessTokenError
When the signatures of the client(game) and the server(BACKND Console) do not match
statusCode : 401
errorCode : BadUnauthorizedExceptionWhen the server and the client time have a difference of 10 minutes or more based on UTC +9(Korean time)
statusCode : 401
errorCode : BadUnauthorizedExceptionWhen the project status in BACKND Console is 'Maintenance'(upon login)
statusCode : 401
errorCode : BadUnauthorizedExceptionOnly applies to Player.CustomSignIn, Player.CustomSignUp, Player.SocialMediaSignIn, Player.AutoSignIn, and Player. ReSignIn methods.
When the project status in BACKND Console is 'Maintenance'(upon calling functions other than login)
statusCode : 401
errorCode : BadUnauthorizedExceptionException handling provider method: IsMaintenanceError
When excessive requests have been detected
This error occurs when at least 1 call per second has been detected from the same IP address.
A client with this error cannot send requests for five minutes.
statusCode : 403
errorCode : ForbiddenException handling provider method: IsTooManyRequestError
<html>
<head><title>403 Forbidden</title></head>
<body>
<center><h1>403 Forbidden</h1></center>
</body>
</html>
When a request is sent during the restricted period after detecting excessive requests
statusCode : 403
errorCode : ForbiddenException handling provider method: IsTooManyRequestError
When you try to sign up/log in to an account with more than 10 users while the server setting in BACKND Console is in test mode
statusCode : 403
errorCode : ForbiddenExceptionWhen attempting to log in from a blocked device
statusCode : 403
errorCode : ForbiddenExceptionWhen a timeout error occurs in the server(up to 20 seconds)
statusCode : 408
errorCode : ECONNABORTEDWhen a timeout error occurs in the SDK(the period set in SDK is passed. default: 100 seconds)
statusCode : 408
errorCode : Timeout1 - 5 can be printed for 'n.'
When the provided capacity in development mode is expired
statusCode : 424
errorCode : FailedDependencyWhen the database quota is exceeded
statusCode : 429
errorCode : ProvisionThroughputExceededExceptionWhen the database quota is being updated
statusCode : 429
errorCode : ProvisionThroughputUpdatingExceptionWhen the server is temporarily overloaded
statusCode : 500
errorCode : InternalServerErrorException handling provider method: IsServerError
- When the server is temporarily overloaded
statusCode : 502
errorCode : BadGatewayException handling provider method: IsServerError
<html>
<head><title>502 Bad Gateway</title></head>
<body>
<center><h1>502 Bad Gateway</h1></center>
</body>
</html>
When the request takes a long time
statusCode : 503
errorCode : ETIMEDOUTIn the case of loading data with complex 'where' clauses or randomly loading users from a table with many pieces of data, the searching process may take too long, resulting in the occurrence of this error.
Exception handling provider method: IsServerErrorWhen the server is not working properly
statusCode : 503
errorCode : Service Temporarily UnavailableException handling provider method: IsServerError
Error cases that occur when upgrading to SDK 5.7.0 or later
- When information is not updated fully after the 5.7.0 version update
statusCode : 410
errorCode : GoneGoneResourceExceptionResourceExceptionWhen an error above occurs, call login methods as shown below to update the information and prevent the error from occurring in the future.
- Backnd.Player.CustomSignIn
- Backnd.Player.GuestLogin
- Backnd.Player.SocialMediaSignIn
- Backnd.Player.AutoSignIn
- Backnd.Player.ReSignIn
Error cases that occur only in SDK versions 5.1.0 or earlier
When the Param value of the method requested to the BACKND server has float/double type data of 14 digits or more(including whole numbers and decimal places)
statusCode : 401
errorCode : BadUnauthorizedExceptionWhen the Param value of the method requested to the BACKND server has Dictionary type data of depth 4 or higher
statusCode : 401
errorCode : BadUnauthorizedException