본문으로 건너뛰기
버전: 5.11.8

모든 Error Cases

ErrorCode 정리

200번대

200번

400번대

400번

401번

402번

403번

404번

405번

408번

409번

410번

412번

413번

428번

429번

500번대

500번

502번

503번

ParseException

200번대 Error Case

200 statusCode


Success

messagereturnValue : {rows:[]}
상황존재하지 않는 columnName일 경우 해당 조건에 만족하는 데이터가 없을 경우
함수GetRandomGuildInfoV3

400번대 Error Case

400 statusCode


accessTokenError

messageaccessToken not exist
상황기기 로컬에 액세스 토큰이 존재하지 않는데 토큰 로그인 시도를 한 경우
함수LoginWithTheBackendToken / RefreshTheBackendToken

BadParameterException

messagebad {column 명} dataType, 잘못된 {column 명} dataType 입니다
상황(스키마) 스키마를 정의할 때 선언한 컬럼의 데이터 타입과 insert, update 하려는 데이터 타입이 다른 경우
함수Insert / Update / UpdateV2

BadParameterException

messagebad {selectedProbabilityCard uuid}{probability id}, 잘못된 {selectedProbabilityCard uuid/probability id} 입니다
상황올바르지 못한 uuid 혹은 id를 입력한 경우
함수GetProbability / GetProbabilitys

BadParameterException

messagebad {title/content} length, 잘못된 {title/content} length 입니다
상황title, contents 가 최소 길이/최대 길이를 만족하지 않는 경우
함수SendPost

BadParameterException

messagebad {컬럼의 데이터 타입} dataType, 잘못된 {컬럼의 데이터 타입} dataType 입니다
상황(스키마) 스키마를 선언한 컬럼의 데이터 타입과 param에 삽입된 컬럼의 데이터 타입이 일치하지 않은 경우
함수UpdateUserScore

BadParameterException

messagebad beginning or end of the nickname must not be blank , 잘못된 beginning or end of the nickname must not be blank 입니다
상황닉네임에 앞/뒤 공백이 있는 경우
함수CheckNicknameDuplication / CreateNickname / UpdateNickname

BadParameterException

messagebad chart id, 잘못된 chart id 입니다
상황올바르지 못한 uuid / id를 입력한 경우
함수GetChartContents / GetOneChartAndSave

BadParameterException

messagebad email is not match, 잘못된 email is not match 입니다
상황잘못된 이메일을 입력한 경우
함수ResetPassword

BadParameterException

messagebad functionName, 잘못된 functionName 입니다
상황함수명에 한글이 포함된 경우
함수InvokeFunction

BadParameterException

messagebad goodsCount is too big, 잘못된 goodsCount is too big 입니다
상황goodsCount가 10 이상인 경우
함수CreateGuildV3

BadParameterException

messagebad goodsType, 잘못된 goodsType 입니다
상황goodsCount 이상의 goodsType에 기부한 경우
함수ContributeGoodsV3

BadParameterException

messagebad guildName, 잘못된 guildName 입니다
상황길드명을 변경 시도한 경우
함수ModifyGuildV3

BadParameterException

messagebad inDate must be, 잘못된 inDate must be 입니다
상황inDate가 null 혹은 string.Empty인 경우
함수UpdateUserScore

BadParameterException

messagebad list data length, 잘못된 list data length 입니다
상황(스키마) 스키마에 list 컬럼을 선언할 때 선택한 list의 크기와 param에 입력한 list의 크기가 다른 경우
함수Insert / Update / UpdateV2

BadParameterException

messagebad map data length, 잘못된 map data length 입니다
상황(스키마) 스키마에 map 컬럼을 선언할 때 선택한 map의 크기와 param에 입력한 map의 크기가 다른 경우
함수Insert / Update / UpdateV2

BadParameterException

messagebad nickname is too long, 잘못된 nickname is too long 입니다
상황20자 이상의 닉네임인 경우
함수CheckNicknameDuplication / CreateNickname / UpdateNickname

BadParameterException

messagebad operator have to been, 잘못된 operator have to been 입니다
상황Param에 AddCalculation 형식으로 데이터를 수정하지 않은 경우
함수UpdateWithCalculation / UpdateWithCalculationV2

BadParameterException

messagebad password is not match, 잘못된 password is not match 입니다
상황잘못된 OldPassword를 입력한 경우
함수UpdatePassword

BadParameterException

messagebad password, 잘못된 password 입니다.
상황잘못된 비밀번호를 입력한 경우
함수ConfirmCustomPassword

BadParameterException

messagebad probability id, 잘못된 probability id 입니다
상황확률에 소수점 8자리 이상의 데이터가 존재할 경우
함수GetProbability / GetProbabilitys

BadParameterException

messagebad rankData column, 잘못된 rankData column 입니다
상황랭킹 생성 시 랭킹 항목으로 등록한 컬럼이 param에 존재하지 않을 경우
함수UpdateUserScore

BadParameterException

messagebad Sender and recipient can not be the same., 잘못된 Sender and recipient can not be the same. 입니다
상황보내는 사람과 받는 사람이 같은 경우
함수SendMessage

BadParameterException

messagebad table, 잘못된 table 입니다
상황갱신을 시도한 랭킹이 굿즈, 메타, 유저 랭킹이 아닌 경우- 랭킹 생성 시 랭킹 항목으로 등록한 테이블이 아닌 경우
함수ContributeGuildGoods / UpdateGuildMetaData / UpdateUserScore / UseGuildGoods

BadParameterException

messagebad token, 잘못된 token 입니다
상황유효하지 않은 영수증 토큰
함수ChargeTBC / IsValidateGooglePurchase

BadParameterException

messagebad type, 잘못된 type 입니다
상황이미 ChangeCustomToFederation 완료되었는데 다시 시도한 경우
함수ChangeCustomToFederation

BadParameterException

messagebad usedTBC, 잘못된 usedTBC 입니다
상황uuid에 해당하는 캐시 아이템을 사는데 TBC가 부족한 경우
함수UseTBC

BadParameterException

messagebad 컬럼이 존재하지 않습니다., 잘못된 컬럼이 존재하지 않습니다.
상황(스키마) 스키마를 정의하지 않은 컬럼을 insert, update 하려고 시도한 경우 / (스키마) 스키마를 정의하지 않은 컬럼이 param에 포함된 경우
함수Insert / Update

ConditionalCheckFailedException

messageThe conditional request failed
상황존재하지 않는 postIndate를 입력한 경우
함수DeleteUserPostItem

HttpRequestException

messageAn error occurred while sending the request(2)Error getting response stream(ReadDone2): ReceiveFailure
상황네트워크의 상태가 일시적으로 불안정하여 호출/응답에 실패할 경우
함수서버 공통 Error Cases

InitializeFail

messagePlease Edit the Backend Settings
상황Client App ID 혹은 Signature Key가 null 혹은 string.Empty인 경우
함수Initialize

InvalidParameterValue

messageUser name is missing: 고유값 no-reply@thebackend.io
상황커스텀 아이디 찾기 시 프로젝트 명에 특수문자가 포함된 경우, 에러 발생과 함께 안내메일 미발송- 커스텀 아이디 비밀번호 찾기 시 프로젝트 명에 특수문자가 포함된 경우, 비밀번호는 변경되지만 에러 발생과 함께 안내메일 미발송
함수FindCustomID / ResetPassword

NotFoundException

messageNot Available OS
상황android, ios 이외의 기기에서 호출된 경우
함수GetLatestVersion

PreconditionFailed

messagevalue only allow more than 0
상황value가 0 이하인 경우
함수ContributeGuildGoods / UseGuildGoods

TransactionDataError

messageNot Support Type in TransactionRead: {에러가 발생한 명령}
상황transactionList에 Get 명령 이외의 작업이 존재하는 경우
함수TransactionRead / TransactionWrite

TransactionSizeError

messageNot Support Transaction Size: {transactionList에 존재하는 작업 개수}
상황transactionList에 10개를 초과하는 작업이 있거나 혹은 작업이 존재하지 않는 경우
함수TransactionRead / TransactionWrite

UndefinedParameterException

messageundefined access_token, access_token을(를) 확인할 수 없습니다
상황customLogin 하지 않은 상황에서 시도한 경우
함수ChangeCustomToFederation

UndefinedParameterException

messageundefined goodsCount must be more then 1, goodsCount must be more then 1을(를) 확인할 수 없습니다
상황goodsCount가 0이하인 경우
함수CreateGuildV3

UndefinedParameterException

messageundefined nickname, nickname을(를) 확인할 수 없습니다
상황빈 닉네임 혹은 string.empty로 닉네임 생성&수정을 시도 한 경우
함수CreateNickname / UpdateNickname

ValidationException

messageAn operand in the update expression has an incorrect data type
상황number형이 아닌 데이터의 수정을 시도한 경우존재하지 않는 컬럼에 수정을 시도한 경우
함수UpdateWithCalculation

ValidationException

messageguildIndate is null or empty
상황guildIndate가 null 혹은 string.Empty인 경우
함수GetGuildRank

ValidationException

messageInvalid UpdateExpression: Expression size has exceeded the maximum allowed size
상황삽입, 수정, 연산하려는 컬럼의 갯수가 총 290개를 넘을 경우- 삽입, 수정, 연산하려는 데이터의 크기가 4MB가 넘을 경우
함수Insert / TransactionWrite / Update / UpdateWithCalculation

ValidationException

messagerankUuid is null or empty
상황uuid가 null 혹은 string.Empty인 경우
함수ContributeGuildGoods / GetGuildRank / GetMyGuildRank / GetMyRank / GetRankList / GetRankListByScore / GetRankRewardList / GetUserRank / UpdateGuildMetaData / UpdateUserScore / UseGuildGoods

ValidationException

messageTransaction request cannot include multiple operations on one item
상황동일한 row에 2개 이상의 작업을 수행했을 경우
함수TransactionRead / TransactionWrite

401 statusCode


BadUnauthorizedException

messagebad accessToken, 잘못된 accessToken 입니다
상황Access Token이 유효하지 않는 경우 or 유저의 Access Token이 올바르지 않거나 만료된 경우(로그인 후 하루 이상 경과한 경우)
함수로그인 시

BadUnauthorizedException

messagebad bad,accessToken,,잘못된,accessToken,입니다, 잘못된 bad,accessToken,,잘못된,accessToken,입니다 입니다
상황Access Token이 유효하지 않는 경우 or 유저의 Access Token이 올바르지 않거나 만료된 경우(로그인 후 하루 이상 경과한 경우)
함수로그인 외 기능 호출 시

BadUnauthorizedException

messagebad BackendFunctionToken, 잘못된 BackendFunctionToken 입니다
상황유니티에서 뒤끝펑션 인증키를 잘못 입력한 경우
함수GetFunctionList / InvokeFunction

BadUnauthorizedException

messagebad facebook app info, 잘못된 bad facebook app info 입니다
상황뒤끝 콘솔에 입력한 페이스북 정보가 잘못되었을 경우
함수AuthorizeFederation

BadUnauthorizedException

messagebad,signature, 잘못된 signature 입니다
상황뒤끝 서버로 요청한 함수의 Param 인자 값 내부에 정수, 소수를 합쳐 14자리 이상의 float/double형 데이터가 포함된 경우 뒤끝서버로 요청한 함수의 Param 인자 값 내부에 4depth를 이상의 Dictionary 타입의 데이터가 포함된 경우
함수서버 공통 Error Cases(SDK 5.1.0 이하 버전에서만 발생)

BadUnauthorizedException

messagebad client_date, 잘못된 client_date입니다
상황서버와 클라이언트의 시간이 UTC+9(한국시간) 기준 10분 이상 차이가 나는 경우
함수서버 공통 Error Cases

BadUnauthorizedException

messagebad customId, 잘못된 customId 입니다
상황존재하지 않는 아이디의 경우- 게스트 계정을 페더레이션 계정으로 변경한 후 게스트 로그인을 시도한 경우
함수CustomLogin / GuestLogin

BadUnauthorizedException

messagebad customPassword, 잘못된 customPassword 입니다
상황비밀번호가 틀린 경우
함수CustomLogin

BadUnauthorizedException

messagebad google_hash, 잘못된 google_hash 입니다
상황안드로이드 OS 환경에서 Client(게임)와 Server(뒤끝 콘솔) 간 구글 해시키가 일치하지 않는 경우
함수서버 공통 Error Cases

BadUnauthorizedException

messagebad refreshToken, 잘못된 refreshToken 입니다
상황다른 기기로 로그인하여 refresh_token이 만료된 경우
함수LoginWithTheBackendToken / RefreshTheBackendToken

BadUnauthorizedException

messagebad senderNickname, 잘못된 senderNickname 입니다
상황보내는 사람의 닉네임이 없는 경우
함수SendMessage

BadUnauthorizedException

messagebad serverStatus: maintenance, 잘못된 serverStatus: maintenance 입니다
상황프로젝트 상태가 '점검'일 경우(접근 허용 유저 제외)
함수CustomLogin / CustomSignUp / AuthorizeFederation / LoginWithTheBackendToken / RefreshTheBackendToken

BadUnauthorizedException

messagebad serverStatus: maintenance, 잘못된 serverStatus: maintenance,입니다
상황프로젝트 상태가 '점검'일 경우(접근 허용 유저 제외)
함수로그인 외 기능 호출 시

BadUnauthorizedException

messagebad signature, 잘못된 signature 입니다
상황Client(게임)와 Server(뒤끝 콘솔) 간 시그니처가 일치하지 않는 경우
함수서버 공통 Error Cases

402 statusCode


AbnormalReceipt

messageThis receipt has changed status. purchaseState: cancelled
상황환불/취소된 영수증
함수ChargeTBC / IsValidateApplePurchase / IsValidateGooglePurchase

403 statusCode


Forbidden

message403 Forbidden
상황한 클라이언트(동일 ip)에서 너무 많은 요청을 보낸 경우 해당 에러가 발생한 클라이언트는 5분 동안 요청을 보낼 수 없습니다.
함수서버 공통 Error Cases

ForbiddenError

messageForbidden applyGuild, 금지된 applyGuild
상황콘솔 설정 조건에 맞지 않는 유저가 길드 가입 요청을 시도한 경우
함수ApplyGuildV3

ForbiddenError

messageForbidden createGuild, 금지된 createGuild
상황콘솔 설정 조건에 맞지 않는 유저가 길드 생성을 시도한 경우
함수CreateGuildV3

ForbiddenException

messageForbidden expelMaster, 금지된 expelMaster
상황권한에 위배되는 회원을 추방 시도한 경우
함수ExpelMemberV3

ForbiddenException

messageForbidden don't send yourself, 금지된 don't send yourself
상황자기 자신에게 보낸 경우
함수SendPost

ForbiddenException

messageForbidden friend, 금지된 friend
상황뒤끝 콘솔의 소셜관리 메뉴에서 친구 최대보유수 설정값이 0인 경우
함수RequestFriend

ForbiddenException

messageForbidden guild Member, 금지된 guild Member
상황마스터 이외의 길드원이 함수를 호출한 경우
함수SetRegistrationValueV3

ForbiddenException

messageForbidden Private table can only be modified by the owner, 금지된 Private table can only be modified by the owner
상황rivate 테이블에서 타인의 정보를 수정, 삭제하고자 하는 경우
함수Delete / DeleteV2 / Update / UpdateV2

ForbiddenException

messageForbidden send message 0, 금지된 send message 0
상황쪽지 최대 보유수가 0인 경우
함수SendMessage

ForbiddenException

messageForbidden useGoods, 금지된 useGoods
상황길드 마스터 이외의 길드원이 해당 함수를 호출한 경우 사용을 시도한 경우
함수UpdateCountryCodeV3 / UseGoodsV3 / UseGuildGoods

콘솔에서 입력한 차단된 사유

messageForbidden blocked user, 금지된 blocked user
상황차단당한 계정, 유저인 경우
함수AuthorizeFederation / CustomLogin / GuestLogin / LoginWithTheBackendToken / RefreshTheBackendToken

404 statusCode


NotFoundException

messagecolumn not found, column을(를) 찾을 수 없습니다
상황스키마를 선언하지 않은 컬럼이 param에 존재할 경우 / null이거나 존재하지 않는 컬럼에 수정을 시도한 경우 / 스키마를 정의하지 않은 컬럼을 where 조건으로 검색하려 한 경우
함수UpdateUserScore / UpdateWithCalculation

NotFoundException

messagecountry not found, country을(를) 찾을 수 없습니다
상황국가 코드가 존재하지 않는 경우
함수GetCountryCodeByIndate / GetMyCountryCode

NotFoundException

messagedata not found, data을(를) 찾을 수 없습니다
상황존재하지 않는 inDate를 기입한 경우 / 타인의 row Indate를 기입한 경우
함수UpdateUserScore

NotFoundException

messageenrolled email not found, enrolled email을(를) 찾을 수 없습니다
상황등록한 이메일이 없는 경우
함수ResetPassword

NotFoundException

messagefederationId not found, federationId을(를) 찾을 수 없습니다
상황유저 정보가 뒤끝 데이터베이스에 없는 경우
함수UpdateFederationEmail

NotFoundException

messagefriendGamer not found, friendGamer을(를) 찾을 수 없습니다
상황gamerIndate가 올바르지 않는 경우 / 해당 유저가 친구가 아닌 경우
함수BreakFriend

NotFoundException

messagegame not found, game을(를) 찾을 수 없습니다
상황Client App ID 혹은 Signature Key가 잘못된 경우
함수Initialize

NotFoundException

messagegameInfo not found, gameInfo을(를) 찾을 수 없습니다
상황where 조건으로 update, delete할 테이블을 검색했으나 테이블이 존재하지 않은 경우 / 존재하지 않는 row의 삭제를 시도한 경우- 존재하지 않는 inDate인 경우 / 스키마를 정의하지 않은 컬럼을 where 조건으로 검색하려 한 경우
함수Update / DeleteV2 / UpdateWithCalculation

NotFoundException

messagegamer not found, gamer을(를) 찾을 수 없습니다
상황해당 이메일의 게이머가 없는 경우 / 존재하지 않는 유저의 userIndate로 조회를 시도할 경우 / 잘못된 CustomId를 입력한 경우
함수FindCustomID / GetUserRank / ResetPassword

NotFoundException

messagegamer가 존재하지 않습니다.
상황해당 닉네임, inDate를 가진 유저가 존재하지 않는 경우
함수GetUserInfoByInDate / GetUserInfoByNickName

NotFoundException

messageguild not found, guild을(를) 찾을 수 없습니다
상황존재하지 않는 길드명, 길드 InDate인 경우 / 길드에 가입하지 않은 유저가 함수를 호출한 경우
함수GetGuildGoodsByIndateV3 / GetGuildIndateByGuildNameV3 / GetGuildInfoV3 / GetGuildMemberListV3 / GetGuildRank / SetRegistrationValueV3

NotFoundException

messageguild rank not found, guild rank을(를) 찾을 수 없습니다
상황길드 랭킹을 생성할 때 선택하지 않은 굿즈로 갱신을 시도한 경우 / 길드 랭킹을 생성할 때 등록한 메타 데이터가 아닌 다른 메타 데이터로 랭킹 갱신을 시도한 경우
함수ContributeGuildGoods / UpdateGuildMetaData / UseGuildGoods

NotFoundException

messageguildMember not found, guildMember을(를) 찾을 수 없습니다
상황길드에 없는 유저일 경우
함수NominateMasterV3 / NominateViceMasterV3 / ReleaseViceMasterV3

NotFoundException

messageguildRank not found, guildRank을(를) 찾을 수 없습니다
상황해당 길드가 랭킹에 존재하지 않는 경우 / 자신의 길드가 랭킹에 존재하지 않는 경우
함수GetGuildRank / GetMyGuildRank

NotFoundException

messageit doesn't exist not found, it doesn't exist을(를) 찾을 수 없습니다
상황ndate(게임 정보)가 잘못된 경우
함수SendPost

NotFoundException

messagemessage not found, message을(를) 찾을 수 없습니다
상황해당 messageIndate의 쪽지가 없는 경우
함수DeleteReceivedMessage / DeleteSentMessage

NotFoundException

messageno matching post not found, no matching post을(를) 찾을 수 없습니다
상황존재하지 않는 postIndate를 입력한 경우
함수ReceiveUserPostItem

NotFoundException

messagenotice not found, notice을(를) 찾을 수 없습니다
상황해당 공지사항, 이벤트가 존재하지 않는 경우
함수EventOne / NoticeOne

NotFoundException

messagepost not found, post을(를) 찾을 수 없습니다
상황존재하지 않는 postIndate를 입력한 경우 / 이미 받은 우편에 대하여 다시 받기를 요청한 경우
함수ReceivePostItem / ReceivePostItemAll

NotFoundException

messageproduct not found, product을(를) 찾을 수 없습니다
상황뒤끝 콘솔에 등록한 제품이 없는 경우
함수GetProductList

NotFoundException

messageproductId not found, productId을(를) 찾을 수 없습니다
상황존재하지 않는 아이템을 구매 시도한 경우
함수ChargeTBCUseTBC

NotFoundException

messagerank not found, rank을(를) 찾을 수 없습니다
상황존재하지 않는 uuid일 경우- 랭킹이 없는 경우
함수GetGuildRank / GetMyGuildRank / GetMyRank / GetRankList / GetRankListByScore / GetRankRewardList / GetRankTableList / GetUserRank / UpdateGuildMetaData

NotFoundException

messagerank reward not found, rank reward을(를) 찾을 수 없습니다
상황보상이 존재하지 않는 uuid로 조회를 시도한 경우
함수GetRankRewardList

NotFoundException

messagerequestedGamer not found, requestedGamer을(를) 찾을 수 없습니다
상황해당 gamerIndate가 존재하지 않는 경우- 해당 유저에게 친구 신청을 하지 않았을 경우
함수ExpelMemberV3 / RejectApplicantV3 / RevokeSentRequest

NotFoundException

messagerequestFriend not found, requestFriend을(를) 찾을 수 없습니다
상황해당 gamerIndate가 친구가 아닐 경우
함수RejectFriend

NotFoundException

messageResource not found, Resource을(를) 찾을 수 없습니다
상황InDate 또는 길드명을 입력하지 않은 경우
함수GetGuildGoodsByIndateV3 / GetGuildIndateByGuildNameV3

NotFoundException

messagetable not found, table을(를) 찾을 수 없습니다
상황존재하지 않는 tableName인 경우
함수Delete / DeleteV2 / Get / GetV2 / GetMyData / GetRandomGuildInfoV3 / Insert / Update / UpdateWithCalculation / UpdateWithCalculationV2 / UpdateV2

NotFoundException

messageuserRank not found, userRank을(를) 찾을 수 없습니다
상황자신의 랭킹이 존재하지 않는 경우 / 해당 유저가 랭킹에 존재하지 않는 경우
함수GetMyRank / GetUserRank

NotFoundException

messageversion not found, version을(를) 찾을 수 없습니다
상황해당 플랫폼 버전이 등록되어 있지 않은 경우
함수GetLatestVersion

NotFoundException

message이미 사용되었거나 틀린 번호입니다. not found, 이미 사용되었거나 틀린 번호입니다.을(를) 찾을 수 없습니다
상황기간 만료된 쿠폰의 경우 / 중복사용이 허용되지 않는 시리얼 쿠폰을 중복 사용한 경우
함수UseCoupon

NotFoundException

message이미 사용하신 쿠폰입니다. not found, 이미 사용하신 쿠폰입니다.을(를) 찾을 수 없습니다
상황한 명의 게이머가 단일 쿠폰을 두 번 이상 사용 시도한 경우
함수UseCoupon

NotFoundException

message전부 사용된 쿠폰입니다. not found, 전부 사용된 쿠폰입니다.을(를) 찾을 수 없습니다
상황단일 쿠폰의 회수율이 100%인 경우
함수UseCoupon

ResourceNotFoundException

messageFunction not found: 호출한 함수 명
상황존재하지 않는 함수명을 호출한 경우
함수InvokeFunction

405 statusCode


MethodNotAllowedParameterException

messageMethodNotAllowed {param value}, 이용할 수 없는 {param value} 입니다
상황partition, gamer_id, inDate, updatedAt, sender, receiver, reservationDate, owner_inDate 8가지 필드가 param에 포함된 경우
함수UpdateWithCalculation / Update / UpdateWithCalculationV2 / UpdateV2

MethodNotAllowedParameterException

messageMethodNotAllowed The recipients message is full, 이용할 수 없는 The recipients message is full 입니다
상황받는 사람의 메시지함이 꽉 찬 경우
함수SendMessage

408 statusCode


ECONNABORTED

messagetimeout error
상황서버에서 타임아웃 오류가 발생한 경우(최대 20초)
함수서버 공통 Error Cases

Timeout

messagetimeout error
상황SDK에서 타임아웃 오류가 발생한 경우(SDK에서 설정한 시간이 지난 이후. default: 100초)
함수서버 공통 Error Cases

409 statusCode


DuplicatedParameterException

messageDuplicated alreadyRequestGamer, 중복된 alreadyRequestGamer 입니다
상황이미 가입 요청한 길드에 다시 가입 요청 한 경우
함수ApplyGuildV3

DuplicatedParameterException

messageDuplicated customId, 중복된 customId 입니다
상황중복된 customId 가 존재하는 경우
함수CustomSignUp

DuplicatedParameterException

messageDuplicated existReqeustFriendGamer, 중복된 existReqeustFriendGamer 입니다
상황이미 친구 요청한 사람에게 다시 요청한 경우
함수RequestFriend

DuplicatedParameterException

messageDuplicated federationId, 중복된 federationId 입니다
상황이미 Federation 계정으로 가입된 계정에 커스텀 아이디 변경을 시도한 경우
함수ChangeCustomToFederation

DuplicatedParameterException

messageDuplicated guildName, 중복된 guildName 입니다
상황중복된 길드명으로 생성 시도한 경우
함수CreateGuildV3

DuplicatedParameterException

messageDuplicated nickname, 중복된 nickname 입니다
상황이미 중복된 닉네임이 있는 경우
함수CheckNicknameDuplication / CreateNickname / UpdateNickname

DuplicatedParameterException

messageDuplicated receipt, 중복된 receipt 입니다
상황이미 사용하거나 취소된 구독 상품의 영수증을 검증한 경우
함수IsValidateGooglePurchase

UsedReceipt

messageThis receipt has already been used. usedDate: 해당 영수증의 사용된 시간
상황이미 사용한 영수증 토큰
함수ChargeTBCIsValidateApplePurchaseIsValidateGooglePurchase

410 statusCode


GoneResourceException

messageGone expired refreshToken, 사라진 expired refreshToken 입니다
상황1년 뒤 refresh_token이 만료된 경우
함수LoginWithTheBackendToken / RefreshTheBackendToken

412 statusCode


PreconditionFailed

messagecontent length 사전 조건을 만족하지 않습니다.
상황contents 글자 수가 콘솔에서 설정한 글자 수보다 큰 경우
함수SendMessage

PreconditionFailed

messageguildName 사전 조건을 만족하지 않습니다.
상황길드명 조건이 맞지 않는 경우
함수CreateGuildV3

PreconditionFailed

messageguild's version is different 사전 조건을 만족하지 않습니다.
상황Old guild를 조회한 경우- Old guild의 유저가 조회한 경우
함수GetGuildInfoV3 / GetMyGuildInfoV3

PreconditionFailed

messageinactiveTable 사전 조건을 만족하지 않습니다.
상황비활성화된 table의 수정/삭제를 시도한 경우 / 비활성화된 tableName에 삽입/불러오기를 시도한 경우
함수Delete / DeleteV2 / Get / GetV2 / GetMyData / Insert / Update / UpdateWithCalculation / UpdateV2 / UpdateWithCalculationV2

PreconditionFailed

messageinadequateAmount 사전 조건을 만족하지 않습니다.
상황보유중인 굿즈의 양보다 많은 양의 굿즈 사용을 시도한 경우
함수UseGoodsV3 / UseGuildGoods

PreconditionFailed

messageJoinedGamer 사전 조건을 만족하지 않습니다.
상황이미 속해있는 길드가 존재하는 경우
함수ApplyGuildV3 / ApproveApplicantV3 / CreateGuildV3

PreconditionFailed

messagemaxGamerFriend 사전 조건을 만족하지 않습니다.
상황요청받은 사람의 friend list 가 꽉 찬 경우
함수AcceptFriend

PreconditionFailed

messagemaxRequestedGamerFriend 사전 조건을 만족하지 않습니다.
상황요청한 사람의 friend list 가 꽉 찬 경우
함수AcceptFriend

PreconditionFailed

messagemaxRequestFriend 사전 조건을 만족하지 않습니다.
상황받는 사람의 request 가 꽉 찬 경우
함수RequestFriend

PreconditionFailed

messagemaxSendFriendRequest 사전 조건을 만족하지 않습니다.
상황보내는 사람의 request 가 꽉 찬 경우
함수RequestFriend

PreconditionFailed

messagememberExist 사전 조건을 만족하지 않습니다.
상황길드 탈퇴를 시도하는 유저가 길드 마스터인데 길드원이 남아있는 경우
함수WithdrawGuildV3

PreconditionFailed

messagenotGuildMember 사전 조건을 만족하지 않습니다.
상황길드에 가입하지 않은 유저가 함수를 호출한 경우
함수ContributeGuildGoods / GetMyGuildGoodsV3 / GetMyGuildInfoV3 / UpdateGuildMetaData / UseGoodsV3 / UseGuildGoods

PreconditionFailed

messagesubscribed guild 사전 조건을 만족하지 않습니다.
상황길드에 가입하지 않은 유저가 메타 정보 변경, 탈퇴를 시도한 경우
함수ModifyGuildV3 / WithdrawGuildV3

PreconditionFailed

messagetype 사전 조건을 만족하지 않습니다.
상황amount 가 음수인 경우
함수ContributeGoodsV3

PreconditionFailed

messagetype 사전 조건을 만족하지 않습니다.
상황amount 가 양수인 경우
함수UseGoodsV3

413 statusCode


ServerErrorException

messagerequest entity too large
상황삽입/업데이트할 데이터의 크기가 400KB를 넘는 경우 / 하나의 row(column들의 집합)이 400KB를 넘는 경우
함수Insert / Update / UpdateWithCalculation / UpdateV2 / UpdateWithCalculationV2

428 statusCode


Precondition Required

messagePrecondition Required ranking is being counted
상황기간이 끝난 일회성 랭킹의 갱신을 시도한 경우 / UTC+9 04:00 ~ 05:00(한국 시간으로 새벽 4시 ~ 5시) 사이에 랭킹 갱신을 시도한 경우
함수ContributeGuildGoods / UpdateGuildMetaData / UpdateUserScore / UseGuildGoods

429 statusCode


ProvisionThroughputExceededException

messageProvisionThroughputExceededException
상황데이터베이스 할당량을 초과한 경우
함수서버 공통 Error Cases

ProvisionThroughputUpdatingException

messageProvisionThroughputUpdatingException
상황데이터베이스 할당량을 업데이트 중인 경우
함수서버 공통 Error Cases

Too Many Request

messageguild member count 요청 횟수를 초과하였습니다.
상황길드원이 이미 100명 이상인 경우
함수ApplyGuildV3 / ApproveApplicantV3

Too Many Request

message정보보호를 위해 아이디 찾기/비밀번호 초기화는 하루 5회로 제한됩니다. 내일 다시 시도해 주세요. 요청 횟수를 초과하였습니다.
상황24시간 이내에 5회 이상 같은 이메일 정보로 아이디/비밀번호 찾기를 시도한 경우
함수FindCustomID / ResetPassword

Too Many Request

message하루에 50개만 가능합니다. 요청 횟수를 초과하였습니다.
상황하루에 50개 이상의 우편을 보낸 경우
함수SendPost

500번대 Error Case

500 statusCode


ServerErrorException

messageCannot read property 'terms' of undefined
상황운영 정책이 등록되어 있지 않는 경우
함수GetPolicy

InternalServerError

message{"message":"Request failed with status code 502"}
상황서버가 일시적으로 과부화 상태일 경우
함수서버 공통 Error Cases

InternalServerError

message{"message":"Request failed with status code 504"}
상황서버가 일시적으로 과부화 상태일 경우
함수서버 공통 Error Cases

502 statusCode


BadGateway

message502 Bad Gateway(정확한 에러 메시지는 서버 공통 Error Cases 페이지 참조)
상황서버가 일시적으로 과부화 상태일 경우
함수서버 공통 Error Cases

503 statusCode


ETIMEDOUT

messageResponse timeout
상황요청에 대한 시간이 오래걸릴 경우
함수서버 공통 Error Cases

Service Temporarily Unavailable

message503 Service Temporarily Unavailable
상황서버가 정상적으로 작동하지 않는 경우
함수서버 공통 Error Cases

ParseException

messageIn order to convert JObject as Param, it must have child value.
상황빈 데이터를 Param으로 변환 시도한 경우 / 자식이 존재하지 않는 json 데이터를 Param으로 변환 시도한 경우
함수Parse