Skip to main content
Version: 5.11.2

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 BackendReturnObject information returned when such errors occur.

Note on exception handling for errors

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 : HttpRequestException

    Error getting response stream(ReadDone2): ReceiveFailure
    Exception handling provider method: IsClientRequestFailError

  • When the device information cannot be found
    statusCode : 400
    errorCode : UndefinedParameterException

  • When the Google hash keys of the client(game) and the server(BACKND Console) do not match in an Android OS environment
    statusCode : 401
    errorCode : BadUnauthorizedException

  • When the user's Access Token is wrong or expired(upon login) \<Refer to the link>
    statusCode : 401
    errorCode : BadUnauthorizedException

    Only applies to BMember.CustomLogin, BMember.CustomSignUp, BMember.AuthorizeFederation, BMember.LoginWithTheBackendToken, and BMember. RefreshTheBackend.Token methods.
    Exception handling provider method: IsBadAccessTokenError

  • When the user's Access Token is wrong or expired(upon calling functions other than login)
    statusCode : 401
    errorCode : BadUnauthorizedException

    Exception handling provider method: IsBadAccessTokenError

  • When the signatures of the client(game) and the server(BACKND Console) do not match
    statusCode : 401
    errorCode : BadUnauthorizedException

  • When the server and the client time have a difference of 10 minutes or more based on UTC +9(Korean time)
    statusCode : 401
    errorCode : BadUnauthorizedException

  • When the project status in BACKND Console is 'Maintenance'(upon login)
    statusCode : 401
    errorCode : BadUnauthorizedException

    Only applies to BMember.CustomLogin, BMember.CustomSignUp, BMember.AuthorizeFederation, BMember.LoginWithTheBackendToken, and BMember. RefreshTheBackendToken methods.

  • When the project status in BACKND Console is 'Maintenance'(upon calling functions other than login)
    statusCode : 401
    errorCode : BadUnauthorizedException

    Exception 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 : Forbidden

    Exception 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 : Forbidden

    Exception 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 : ForbiddenException

  • When attempting to log in from a blocked device
    statusCode : 403
    errorCode : ForbiddenException

  • When a timeout error occurs in the server(up to 20 seconds)
    statusCode : 408
    errorCode : ECONNABORTED

  • When a timeout error occurs in the SDK(the period set in SDK is passed. default: 100 seconds)
    statusCode : 408
    errorCode : Timeout

    1 - 5 can be printed for 'n.'

  • When the provided capacity in development mode is expired
    statusCode : 424
    errorCode : FailedDependency

  • When the database quota is exceeded
    statusCode : 429
    errorCode : ProvisionThroughputExceededException

  • When the database quota is being updated
    statusCode : 429
    errorCode : ProvisionThroughputUpdatingException

  • When the server is temporarily overloaded
    statusCode : 500
    errorCode : InternalServerError

    Exception handling provider method: IsServerError

  • When the server is temporarily overloaded
    statusCode : 502
    errorCode : BadGateway Exception 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 : ETIMEDOUT

    In 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: IsServerError

  • When the server is not working properly
    statusCode : 503
    errorCode : Service Temporarily Unavailable

    Exception 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 : GoneGoneResourceExceptionResourceException When an error above occurs, call login methods as shown below to update the information and prevent the error from occurring in the future.
    • Backend.BMember.CustomLogin
    • Backend.BMember.GuestLogin
    • Backend.BMember.AuthorizeFederation
    • Backend.BMember.LoginWithTheBackendToken
    • Backend.BMember.RefreshTheBackendToken

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 : BadUnauthorizedException

  • When the Param value of the method requested to the BACKND server has Dictionary type data of depth 4 or higher
    statusCode : 401
    errorCode : BadUnauthorizedException