버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

코드

이름

설명

200

Success

  • 성공

400

BadRequest

  • 잘못된 요청

    • 서버에 전달 된 요청이 잘못된 경우(파싱되지 않는 요청 데이터. 필수 파라미터 부족 or 파라미터 타입 오류) 일 때 발생합니다

401

AuthFailure

  • 인증 실패

    • 자동/수동 로그인 시 전달된 IDP 의 Access Token이 유효하지 않은 경우 발생합니다.

403

Forbidden

  • 허용되지 않는 요청

    • 권한이 없는 사용자가 요청을 보낼 때 발생합니다.

    • 예) CBT기간 동안 특정 유저에게만 인증이 가능하도록 제한할 수 있습니다.

404

NotFound

  • 지원하지 않는 기능

    • 존재하지 않는 서버 API를 호출 할 때 발생합니다.

406

NotExistData

  • 존재하지 않는 데이터를 요청하거나 허용된 범위를 벗어난 요청을 할 때 발생합니다.

    • 예) 존재하지 않는 쿠폰 등록 등의 동작

    • 예) 계정 전환 시 전환을 요청한 계정이 이미 게임에 가입 되어 있는 계정인 경우

406

AlreadyUsedIdpAccount

  • 이미 사용중인 계정으로 계정 전환을 시도할 경우 발생 합니다.

409

ConflictData

  • 데이터 중복 발생

    • 덮어쓰기가 불가능한 데이터를 다시 등록하려고 할때 발생합니다.

461

Punishment

  • 사용자 처벌

473

ServiceUnavailable

  • 서비스 사용 불가(점검)

    • 플랫폼 서버가 서비스 가능하지 않은 상태(플랫폼 서버 점검 등) 일 때 발생합니다.

483

NotAllowed

  • 허용되지 않음

    • 예) CBT기간 동안 특정 유저에게만 인증이 가능하도록 제한할 수 있습니다.

493

AccountCreationLimit

  • 계정 생성 제한

    • 하나의 adid에 대해서 특정 기간 내에 특정 개수 이상 생성되는 경우에 에러가 발생합니다.

500

InternalError

  • 서버 시스템 내부 오류

    • 서버 내부에서 오류가 발생한 경우 발생합니다.

1001

NetworkFailure

  • 네트워크 오류 발생

    • 기기의 네트워크(3g/lte/wifi 등) 연결이 되어 있지 않은 상태에 발생합니다.

2001

ServerTimeout

  • 서버 타임아웃

    • 서버 응답이 일정 시간(20초) 동안 오지 않은 경우 발생합니다.

2002

ServerException

  • 서버 동작 중 예외 발생

    • 서버 응답을 처리하는 도중 예외 상황이 발생할 때 리턴됩니다.

2003

InvalidResponse

  • 서버에서 잘못된 응답을 전송.

    • 서버에서 잘못된 응답을 전송할 때 발생합니다.

2004

ConnectionFailed

  • 세션 서버에 접속 실패 or 세션 서버 응답 대기 중 세션이 끊어 짐

    • 세션 서버를 통해 요청을 보내서 응답을 기다리는 상태에서 세션이 끊어지는(네트워크 전환등의 이유로 끊김) 경우 발생합니다.

3000

InitializationFailed

  • 초기화 실패

    • 플랫폼 초기화가 실패한 경우입니다. 플랫폼 환경설정에 문제가 생긴 경우로 에러 메시지 description을 확인하여 문제가 되는 부분을 확인 할 수 있습니다.

3001

NotInitialized

  • 초기화되지 않음

    • 초기화 하지 않은 상태에서 initialize/start 이외의 API를 호출 할 때 발생합니다.

3002

NotAuthorized

  • 인증 되지 않은 상태.

    • 인증 되지 않은 상태에서 인증 API를 제외한 나머지 API를 호출할 때 발생합니다

4000

InvalidParameter

  • 파라미터 오류.

    • API 호출 시 전달되는 파라미터에 문제가 발생하였을 때 발생합니다.

4001

ClientException

  • 클라이언트 동작 중 예외 발생.

    • 클라이언트 SDK 동작 중 예외 상황이 발생하면 리턴됩니다.

4002

InvalidState

  • 요청을 처리할 수 없는 상태.

    • 예) 계정 전환 요청 시 현재 인증이 기기 인증이 아닌 경우

    • 예) 카카오스토리 유저가 아닌데, 카카오스토리 API를 호출하는 경우|

4003

InProgress

  • 호출한 API가 이미 진행중.

    • 예) start api진행중에, start api 호출할 경우

    • 예) login api진행중에, login api 호출할 경우

4010

IdpAuthFailure

  • IDP 인증 실패.

    • IDP(카카오/페이스북/구글 등) 인증 에러가 발생하였을 때 리턴됩니다.

5001

NotSupported

  • 지원하지 않음.

    • 채널링 게임에서 쿠폰은 지원하지 않는 기능인데, 쿠폰 API를 사용할때

    • 디바이스 인증을 한 상태에서 카카오 API를 사용할 때

6001

APINotExists

  • 요청한 API가 존재하지 않음.

    • 인터페이스 브로커를 통해 요청한 API 가 존재하지 않음

7001

ExceedMonthlyUsage

  • 월간 허용된 사용량을 초과.

7002

ExceedDailyUsage

  • 일간 허용된 사용량을 초과.

7003

ExceedMaxUploadSize

  • 최대 업로드 사이즈를 초과.

7004

ExceedMaxUploadNumber

  • 최대 업로드 개수를 초과.

7101

MessageSettingDisabled

  • 메시지 전송시, 수신자의 메시지 상태가 disable되어 있음.

7201

KakaoTalkNotInstalled

  • 카카오톡이 설치되어 있지 않음.

7202

NotKakaoTalkUser

  • 카카오톡 유저가 아님

9001

UserCanceled

  • 사용자가 취소함.

    • IDP인증, 쿠폰 등록 등 사용자 인터렉션이 있는 동작에서 사용자가 취소하는 경우 발생합니다.

9999

Unknown

  • 알 수 없는 오류

    • 예측할 수 없는 곳에서 에러가 발생하는 경우 리턴됩니다.