Skip to main content
Version: SDK-5.11.2

All Error Cases

statusCodeerrorCodemessageSituationMethod
200SuccessreturnValue : {rows:[]}- When the columnName does not exist
- When no data meets the conditions
GetRandomGuildInfoV3
400accessTokenErroraccessToken not exist- When the user tries token login but there is no local access token in the deviceLoginWithTheBackendToken
RefreshTheBackendToken
400BadParameterExceptionbad {column name} dataType, Invalid {column name} dataType-(Schema) When the data type of the column declared upon defining the schema is different from that of the column to be inserted and updatedInsert
Update
UpdateV2
400BadParameterExceptionbad {selectedProbabilityCard uuid}{probability id}, Invalid {selectedProbabilityCard uuid/probability id}- When the wrong uuid or id is enteredGetProbability
GetProbabilitys
400BadParameterExceptionbad {title/content} length, Invalid {title/content} length- When the title/content does not meet the minimum/maximum lengthSendPost
400BadParameterExceptionbad {data type of column} dataType, Invalid {data type of column} dataType-(Schema) When the data type of the column that declared the schema is different from the data type of the column inserted to paramUpdateUserScore
400BadParameterExceptionbad beginning or end of the nickname must not be blank , the beginning or end of the nickname must not be a blank- When there is a blank before/after the nicknameCheckNicknameDuplication
CreateNickname
UpdateNickname
400BadParameterExceptionbad chart id, Invalid chart id- When the wrong uuid/id is enteredGetChartContents
GetOneChartAndSave
400BadParameterExceptionbad email is not match, Invalid email- When the wrong email is enteredResetPassword
400BadParameterExceptionbad functionName, Invalid functionName- When a Korean character is included in the method nameInvokeFunction
400BadParameterExceptionbad goodsCount is too big, The goodsCount is too big- When the goodsCount more than 10CreateGuildV3
400BadParameterExceptionbad goodsType, Invalid goodsType- When the contributed goodsType exceeds the goodsCountContributeGoodsV3
400BadParameterExceptionbad guildName, Invalid guildName- When there is an attempt to modify the guild nameModifyGuildV3
400BadParameterExceptionbad inDate must be, Invalid inDate- When the inDate is null or string.EmptyUpdateUserScore
400BadParameterExceptionbad list data length, Invalid list data length-(Schema) When the size of the list selected upon declaring the list column in the schema is different from the size of the list entered in paramInsert
Update
UpdateV2
400BadParameterExceptionbad map data length, Invalid map data length-(Schema) When the size of the map selected upon declaring the map column in the schema is different from the size of the map entered in paramInsert
Update
UpdateV2
400BadParameterExceptionbad nickname is too long, The nickname is too long- When the nickname exceeds 20 charactersCheckNicknameDuplication
CreateNickname
UpdateNickname
400BadParameterExceptionbad operator have to been, Invalid operator- When the data in Param is not modified as AddCalculation typeUpdateWithCalculation
UpdateWithCalculationV2
400BadParameterExceptionbad password is not match, Password does not match- When an invalid OldPassword is enteredUpdatePassword
400BadParameterExceptionbad password, Invalid password.- When the wrong password is enteredConfirmCustomPassword
400BadParameterExceptionbad probability id, Invalid probability id- When there is data with 8 or more decimal places in the probabilityGetProbability
GetProbabilitys
400BadParameterExceptionbad rankData column, Invalid rankData column- When the table registered as a ranking field upon creating the ranking is not in paramUpdateUserScore
400BadParameterExceptionbad Sender and recipient can not be the same., The sender and recipient cannot be the same- When the sender and recipient are the sameSendMessage
400BadParameterExceptionbad table, Invalid table- When the ranking that attempted the update is not goods, meta, or user ranking
- When the table is not the one registered as a ranking field upon creating the ranking
ContributeGuildGoods
UpdateGuildMetaData
UpdateUserScore
UseGuildGoods
400BadParameterExceptionbad token, Invalid token- Expired receipt tokenChargeTBC
IsValidateGooglePurchase
400BadParameterExceptionbad type, Invalid type- When ChangeCustomToFederation was completed but another attempt is madeChangeCustomToFederation
400BadParameterExceptionbad usedTBC, Invalid usedTBC- When there is not enough TBC to purchase the cash item of the corresponding uuidUseTBC
400BadParameterExceptionbad column does not exist., The column does not exist-(Schema) When there is an attempt to insert or update a column whose schema is not defined
-(Schema) When a column whose schema is not defined is included in param
Insert
Update
400ConditionalCheckFailedExceptionThe conditional request failed- When a non-existent postIndate is enteredDeleteUserPostItem
400HttpRequestExceptionAn error occurred while sending the request(2)
Error getting response stream(ReadDone2): ReceiveFailure
- When the call/response fails because the network is temporarily unstableCommon Server Error Cases
400InitializeFailPlease Edit the Backend Settings- When the Client App ID or Signature Key is null or string.EmptyInitialize
400InvalidParameterValueUser name is missing: unique value no-reply@thebackend.io;'.- When a special character is included in the project name upon finding custom ID, an error occurs and a notice email is not sent
- When a special character is included in the project name upon finding custom ID and password, the password is changed but an error occurs and a notice email is not sent
FindCustomID
ResetPassword
400NotFoundExceptionNot Available OS- When called in non-Android and non-iOS devicesGetLatestVersion
400PreconditionFailedvalue only allow more than 0- When the value is 0 or lowerContributeGuildGoods
UseGuildGoods
400TransactionDataErrorNot Support Type in TransactionRead: {Command with the error}- When there is a task other than the Get command in transactionListTransactionRead
TransactionWrite
400TransactionSizeErrorNot Support Transaction Size: {Number of tasks in transactionList}- When there are over 10 tasks in transactionList, or when there are no tasksTransactionRead
TransactionWrite
400UndefinedParameterExceptionundefined access_token, access_token cannot be checked- When there is an attempt without customLoginChangeCustomToFederation
400UndefinedParameterExceptionundefined goodsCount must be 1 or higher, Cannot check goodsCount is 1 or higher- When the goodsCount is 0 or lowerCreateGuildV3
400UndefinedParameterExceptionundefined nickname, nickname cannot be checked- When the user tries to create/modify a nickname using an empty nickname or string.emptyCreateNickname
UpdateNickname
400ValidationExceptionAn operand in the update expression has an incorrect data type- When there is an attempt to modify data that is not a number type
When there is an attempt to modify a non-existent column
UpdateWithCalculation
400ValidationExceptionguildIndate is null or empty- When the guildIndate is null or string.EmptyGetGuildRank
400ValidationExceptionInvalid UpdateExpression: Expression size has exceeded the maximum allowed size;- When the total number of columns to be inserted, edited, or calculated is over 290
- When the size of the data to be inserted, edited, or calculated is over 4 MB
Insert
TransactionWrite
Update
UpdateWithCalculation
400ValidationExceptionrankUuid is null or empty- When the uuid is null or string.EmptyContributeGuildGoods
GetGuildRank
GetMyGuildRank
GetMyRank
GetRankList
GetRankListByScore
GetRankRewardList
GetUserRank
UpdateGuildMetaData
UpdateUserScore
UseGuildGoods
400ValidationExceptionTransaction request cannot include multiple operations on one item- When 2 or more tasks are performed to the same rowTransactionRead
TransactionWrite
401BadUnauthorizedExceptionbad accessToken, Invalid accessToken- When the Access Token is not valid
- When the user's Access Token is wrong or expired(one day or more has passed since login)
Upon login
401BadUnauthorizedExceptionbad bad,accessToken,,Invalid accessToken, Invalid bad, accessToken,, Invalid accessToken- When the Access Token is not valid
- When the user's Access Token is wrong or expired(one day or more has passed since login)
Upon calling functions other than login
401BadUnauthorizedExceptionbad BackendFunctionToken, Invalid BackendFunctionToken- When an incorrect BACKND Function authorization key is entered in UnityGetFunctionList
InvokeFunction
401BadUnauthorizedExceptionbad bad facebook app info, Invalid bad facebook app info- When the Facebook information entered in BACKND Console is invalidAuthorizeFederation
401BadUnauthorizedExceptionbad bad,signature,,Invalid signature, Invalid bad, signature,, Invalid signature- 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)
- When the Param value of the method requested to the BACKND server has Dictionary type data of depth 4 or higher
Common Server Error Cases(occurs only in SDK 5.1.0 and earlier versions)
401BadUnauthorizedExceptionbad client_date, Invalid client_date- When the server and the client time have a difference of 10 minutes or more based on UTC +9(Korean time)Common Server Error Cases
401BadUnauthorizedExceptionbad customId, Invalid customId- When the ID does not exist
- When a guest login was attempted after changing the guest account to a federation account
CustomLogin
GuestLogin
401BadUnauthorizedExceptionbad customPassword, Invalid customPassword- When the password is incorrectCustomLogin
401BadUnauthorizedExceptionbad google_hash, Invalid google_hash- When the Google hash keys of the client(game) and the server(BACKND Console) do not match in an Android OS environmentCommon Server Error Cases
401BadUnauthorizedExceptionbad refreshToken, Invalid refreshToken- When the refresh_token expired because the user logged in to another deviceLoginWithTheBackendToken
RefreshTheBackendToken
401BadUnauthorizedExceptionbad senderNickname, Invalid senderNickname- When the sender does not have a nicknameSendMessage
401BadUnauthorizedExceptionbad serverStatus: maintenance, Invalid serverStatus: maintenance- When the project status is 'Maintenance'(whitelisted users excluded)CustomLogin
CustomSignUp
AuthorizeFederation
LoginWithTheBackendToken
RefreshTheBackendToken
401BadUnauthorizedExceptionbad bad,serverStatus:,maintenance,,Invalid serverStatus:,maintenance, Invalid bad,serverStatus:,maintenance,,Invalid serverStatus:,maintenance- When the project status is 'Maintenance'(whitelisted users excluded)Upon calling functions other than login
401BadUnauthorizedExceptionbad signature, Invalid signature- When the signatures of the client(game) and the server(BACKND Console) do not matchCommon Server Error Cases
402AbnormalReceiptThis receipt has changed status. purchaseState: cancelled- Refunded/canceled receiptChargeTBC
IsValidateApplePurchase
IsValidateGooglePurchase
403Forbidden403 Forbidden- When too many requests are sent from one client(same IP)
- A client with this error cannot send requests for five minutes.
Common Server Error Cases
403ForbiddenErrorForbidden applyGuild, Cannot join Guild- When a user who does not meet the console setting conditions attempts to request to join a guildApplyGuildV3
403ForbiddenErrorForbidden createGuild, Cannot create guild- When a user who does not meet the console setting conditions attempts to create a guildCreateGuildV3
403ForbiddenExceptionForbidden expelMaster, Cannot expel- When a user attempts to expel a member without the proper authorityExpelMemberV3
403ForbiddenExceptionForbidden don't send yourself, Cannot send to yourself- When you send it to yourselfSendPost
403ForbiddenExceptionForbidden friend, Cannot add friend- When the maximum number of friends setting value is 0 in the social management menu of BACKND ConsoleRequestFriend
403ForbiddenExceptionForbidden guild Member, Forbidden guild member- When a guild member who is not the master calls the methodSetRegistrationValueV3
403ForbiddenExceptionForbidden Private table can only be modified by the owner, Private table can only be modified by the owner- When an attempt is made to modify or delete the information of another person in the private tableDelete
DeleteV2
Update
UpdateV2
403ForbiddenExceptionForbidden send message 0, Cannot send message- When the maximum number of owned messages is 0SendMessage
403ForbiddenExceptionForbidden useGoods, Cannot use goods- When a guild member other than the guild master attempts to use goods by calling the methodUpdateCountryCodeV3
UseGoodsV3
UseGuildGoods
403Reason for blocking entered in the consoleforbidden blocked user, Blocked user- When the account/user is blockedAuthorizeFederation
CustomLogin
GuestLogin
LoginWithTheBackendToken
RefreshTheBackendToken
404NotFoundExceptioncolumn not found, column cannot be found-(Schema) When a column whose schema is not declared is in param
-(Schema) When there is an attempt to modify a null or non-existent column
- When there is an attempt to search for a column whose schema is not defined with the where condition
UpdateUserScore
UpdateWithCalculation
UpdateWithCalculation
404NotFoundExceptioncountry not found, country cannot be found- When the country code does not existGetCountryCodeByIndate
GetMyCountryCode
404NotFoundExceptiondata not found, data cannot be found- When a non-existent inDate is entered / When another person's row Indate is enteredUpdateUserScore
404NotFoundExceptionenrolled email not found, enrolled email cannot be found- When there is no enrolled emailResetPassword
404NotFoundExceptionfederationId not found, federationId cannot be found- When the user information is not in the BACKND databaseUpdateFederationEmail
404NotFoundExceptionfriendGamer not found, friendGamer cannot be found- When the gamerIndate is wrong / When the user is not a friendBreakFriend
404NotFoundExceptiongame not found, game cannot be found- When the Client App ID or Signature Key is invalidInitialize
404NotFoundExceptiongameInfo not found, gameInfo cannot be found- When the user searches the table to update or delete with the where condition but the table does not exist
- When the user tries to delete a non-existent row
- When the inDate does not exist
-(Schema) When there is an attempt to search for a column whose schema is not defined with the where condition
Delete
DeleteV2
Update
UpdateWithCalculation
404NotFoundExceptiongamer not found, gamer cannot be found- When the gamer with the given email does not exist
- When there is an attempt to look up with a userIndate of a non-existent user
- When the wrong CustomId is entered
FindCustomID
GetUserRank
ResetPassword
404NotFoundExceptiongamer does not exist- When there is no user with that nickname or inDateGetUserInfoByInDate
GetUserInfoByNickName
404NotFoundExceptionguild not found, guild cannot be found- When the guild name or guild InDate does not exist
- When a user who has not joined a guild calls the method
GetGuildGoodsByIndateV3
GetGuildIndateByGuildNameV3
GetGuildInfoV3
GetGuildMemberListV3
GetGuildRank
SetRegistrationValueV3
404NotFoundExceptionguild rank not found, guild rank cannot be found- When the user tries to update with goods not selected during ranking creation
- When there is an attempt to update the ranking with other metadata, not the one registered when creating the guild ranking
ContributeGuildGoods
UpdateGuildMetaData
UseGuildGoods
404NotFoundExceptionguildMember not found, guildMember cannot be found- When the user is not in the guildNominateMasterV3
NominateViceMasterV3
ReleaseViceMasterV3
404NotFoundExceptionguildRank not found, guildRank cannot be found- When the guild does not exist in the ranking
- When your guild does not exist in the ranking
GetGuildRank
GetMyGuildRank
404NotFoundExceptionit doesn't exist not found, It doesn't exist- When the indate(game information) is invalidSendPost
404NotFoundExceptionmessage not found, message cannot be found- When there is no message for the corresponding messageIndateDeleteReceivedMessage
DeleteSentMessage
404NotFoundExceptionno matching post not found, Matching post cannot be found- When a non-existent postIndate is enteredReceiveUserPostItem
404NotFoundExceptionnotice not found, notice cannot be found- When the corresponding announcement/event does not existEventOne
NoticeOne
404NotFoundExceptionpost not found, mail cannot be found- When a non-existent postIndate is entered
- When it is a request to receive a piece of mail that has already been received
ReceiveAdminPostItemV2
ReceiveUserPostItem
404NotFoundExceptionproduct not found, product cannot be found- When there is no product registered in BACKND ConsoleGetProductList
404NotFoundExceptionproductId not found, productId cannot be found- When there is an attempt to purchase a non-existent itemChargeTBC
UseTBC
404NotFoundExceptionrank not found, rank cannot be found- When the uuid does not exist
- When the ranking does not exist
GetGuildRank
GetMyGuildRank
GetMyRank
GetRankList
GetRankListByScore
GetRankRewardList
GetRankTableList
GetUserRank
UpdateGuildMetaData
404NotFoundExceptionrank reward not found, rank reward cannot be found- When there is an attempt to look up with a uuid that has no rewardGetRankRewardList
404NotFoundExceptionrequestedGamer not found, requestedGamer cannot be found- When the gamerIndate does not exist
- When a friend request was not made to the corresponding user
ExpelMemberV3
RejectApplicantV3
RevokeSentRequest
404NotFoundExceptionrequestFriend not found, requestFriend cannot be found- When the corresponding gamerIndate is not a friendRejectFriend
404NotFoundExceptionResource not found, resource cannot be found- When the InDate or guild name is not enteredGetGuildGoodsByIndateV3
GetGuildIndateByGuildNameV3
404NotFoundExceptiontable not found, table cannot be found- When the tableName does not existDelete
DeleteV2
Get
GetV2
GetMyData
GetRandomGuildInfoV3
GetRandomUserInfo
Insert
Update
UpdateWithCalculation
UpdateV2
UpdateWithCalculationV2
404NotFoundExceptionuserRank not found, userRank cannot be found- When your rank does not exist
- When the user does not exist in the ranking
GetMyRank
GetUserRank
404NotFoundExceptionversion not found, version cannot be found- When the platform version is not registeredGetLatestVersion
404NotFoundExceptionAlready used or incorrect code. not found, Already used or incorrect code. Cannot be found- When the coupon has expired
- When a serial coupon that is prohibited from duplicate use is used again
UseCoupon
404NotFoundExceptionCoupon already used. not found, Coupon is already used and cannot be found- When a gamer attempts to redeem a single coupon more than onceUseCoupon
404NotFoundExceptionAll of this coupon has been used. not found, Cannot be found because all of this coupon has been used- When the recovery rate of a single coupon is 100%UseCoupon
404ResourceNotFoundExceptionFunction not found: name of the called method- When a non-existent method name is calledInvokeFunction
405MethodNotAllowedParameterExceptionMethodNotAllowed {param value}, Unavailable {param value}- When the eight fields(partition, gamer_id, inDate, updatedAt, sender, receiver, reservationDate, and owner_inDate) are included in paramUpdateWithCalculation
Update
UpdateWithCalculationV2
UpdateV2
405MethodNotAllowedParameterExceptionMethodNotAllowed The recipients message is full., The recipient's message is full and cannot be used.- When the recipient's messages are fullSendMessage
408ECONNABORTEDtimeout error- When a timeout error occurs in the server(up to 20 seconds)Common Server Error Cases
408Timeouttimeout error- When a timeout error occurs in the SDK(the period set in SDK is passed. default: 100 seconds)Common Server Error Cases
409DuplicatedParameterExceptionDuplicated alreadyRequestGamer, Duplicated alreadyRequestGamer- When it is a request to join the same guild againApplyGuildV3
409DuplicatedParameterExceptionDuplicated customId, Duplicated customId- When there is a duplicated customIdCustomSignUp
409DuplicatedParameterExceptionDuplicated existReqeustFriendGamer, Duplicated existReqeustFriendGamerWhen another friend request is made to someone after already sending a friend requestRequestFriend
409DuplicatedParameterExceptionDuplicated federationId, Duplicated federationId- When there is an attempt to change the custom ID that is already signed up as a federation accountChangeCustomToFederation
409DuplicatedParameterExceptionDuplicated guildName, Duplicated guildName- When there is an attempt to create a guild with a duplicated guild nameCreateGuildV3
409DuplicatedParameterExceptionDuplicated nickname, Duplicated nickname- When there is a duplicated nicknameCheckNicknameDuplication
CreateNickname
UpdateNickname
409DuplicatedParameterExceptionDuplicated receipt, Duplicated receipt- When the receipt for an already used or canceled subscription product is verifiedIsValidateGooglePurchase
409UsedReceiptThis receipt has already been used. usedDate: the time the receipt was used- Already used receipt tokenChargeTBC
IsValidateApplePurchase
IsValidateGooglePurchase
410GoneResourceExceptionGone expired refreshToken, refreshToken does not exist- When the refresh_token has expired after one yearLoginWithTheBackendToken
RefreshTheBackendToken
412PreconditionFailedcontent length prerequisites are not met.- When the number of characters in the content is greater than the number set in the consoleSendMessage
412PreconditionFailedguildName prerequisites are not met.- When the guild name conditions are not metCreateGuildV3
412PreconditionFailedThe prerequisites for different guild versions are not met.- When the old guild is looked up
- When a user in the old guild looks up
GetGuildInfoV3
GetMyGuildInfoV3
412PreconditionFailedinactiveTable prerequisites are not met.- When there is an attempt to modify/delete a deactivated table
- When there is an attempt to insert/load into a deactivated tableName
Delete
DeleteV2
Get
GetV2
GetMyData
Insert
Update
UpdateWithCalculation
UpdateV2
UpdateWithCalculationV2
412PreconditionFailedinadequateAmount prerequisites are not met.- When there is an attempt to use goods more than the amount owned by the guildUseGoodsV3
UseGuildGoods
412PreconditionFailedJoinedGamer prerequisites are not met.- When the user is already in a guildApplyGuildV3
ApproveApplicantV3
CreateGuildV3
412PreconditionFailedmaxGamerFriend prerequisites are not met.- When the friend list of the person who received the request is fullAcceptFriend
412PreconditionFailedmaxRequestedGamerFriend prerequisites are not met.- When the friend list of the person who sent the request is fullAcceptFriend
412PreconditionFailedmaxRequestFriend prerequisites are not met.- When the recipient's requests are fullRequestFriend
412PreconditionFailedmaxSendFriendRequest prerequisites are not met.- When the sender's requests are fullRequestFriend
412PreconditionFailedmemberExist prerequisites are not met.- When the guild master attempts to withdraw from the guild but there are guild members remainingWithdrawGuildV3
412PreconditionFailednotGuildMember prerequisites are not met.- When a user who has not joined a guild calls the methodContributeGuildGoods
GetMyGuildGoodsV3
GetMyGuildInfoV3
UpdateGuildMetaData
UseGoodsV3
UseGuildGoods
412PreconditionFailedsubscribed guild prerequisites are not met.- When a user who has not joined the guild attempts to change the metadata or withdrawModifyGuildV3
WithdrawGuildV3
412PreconditionFailedtype prerequisites are not met.- When the amount is a negative numberContributeGoodsV3
412PreconditionFailedtype prerequisites are not met.- When the amount is a positive numberUseGoodsV3
413ServerErrorExceptionrequest entity too large- When the size of data to be inserted or updated exceeds 400 KB
- When one row(group of columns) exceeds 400 KB
Insert
Update
UpdateWithCalculation
UpdateV2
UpdateWithCalculationV2
428Precondition RequiredPrecondition Required ranking is being counted- When there is an attempt to update an expired one-time ranking
- When there is an attempt to update the ranking during UTC +9 04:00 - 05:00(4 am - 5 am in Korean time)
ContributeGuildGoods
UpdateGuildMetaData
UpdateUserScore
UseGuildGoods
429ProvisionThroughputExceededExceptionProvisionThroughputExceededException- When the database quota is exceededCommon Server Error Cases
429ProvisionThroughputUpdatingExceptionProvisionThroughputUpdatingException- When the database quota is being updatedCommon Server Error Cases
429Too Many Requestguild member request count is exceeded.- When the number of guild members is already more than 100ApplyGuildV3
ApproveApplicantV3
429Too Many RequestTo protect your information, Find ID/Initialize Password is available only 5 times a day. Please try again tomorrow. You have reached the maximum number of requests.- When there is an attempt to find ID or password more than 5 times using the same information within 24 hoursFindCustomID
ResetPassword
429Too Many RequestYou may only send 50 a day. You have exceeded the request count.- When you send more than 50 pieces of mail a daySendPost
500ServerErrorExceptionCannot read property 'terms' of undefined- When the Operation Policy is not registeredGetPolicy
500InternalServerError{"message":"Request failed with status code 502"}- When the server is temporarily overloadedCommon Server Error Cases
500InternalServerError{"message":"Request failed with status code 504"}- When the server is temporarily overloadedCommon Server Error Cases
502BadGateway502 Bad Gateway
(Refer to the Common Server Error Cases page for the exact error message)
- When the server is temporarily overloadedCommon Server Error Cases
503ETIMEDOUTResponse timeout- When the request takes a long timeCommon Server Error Cases
503Service Temporarily Unavailable503 Service Temporarily Unavailable- When the server is not working properlyCommon Server Error Cases
ParseExceptionIn order to convert JObject as Param, it must have child value.- When there is an attempt to convert empty data to param
- When there is an attempt to convert the JSON data without a child to Param
Parse