페이지 이동경로
  • 문서>
  • REST API>
  • 에러 코드

REST API

에러 코드

아래는 카카오 API 제품별로 발생할 수 있는 에러 코드 정보입니다. 에러 발생 시 code 중 해당하는 항목을 찾아 원인을 파악합니다.

공통

에러 코드 상태 코드 원인 해결 방법
-1 400 서버 내부에서 처리 중에 에러가 발생한 경우 재시도
-2 400 필수 인자가 포함되지 않은 경우나 호출 인자값의 데이타 타입이 적절하지 않거나 허용된 범위를 벗어난 경우 요청 파라미터 확인
-3 403 해당 API를 사용하기 위해 필요한 기능(간편가입, 동의항목, 서비스 설정 등)이 활성화 되지 않은 경우 앱 관리 페이지에서 필요한 기능을 선택한 후, [사용 설정]에서 ON으로 설정한 후 재호출
-4 403 계정이 제재된 경우나 해당 계정에 제재된 행동을 하는 경우 -
-5 403 해당 API에 대한 요청 권한이 없는 경우 해당 API의 이해하기 문서를 참고해 권한 획득 후 재호출
-6 403 카카오 서비스에서 허용하지 않는 동작을 요청한 경우 해당 API 문서를 참고해 카카오 서비스가 허용하는 범위 내 동작으로 재요청
-7 400 서비스 점검 또는 내부 문제가 있는 경우 해당 서비스 공지사항 확인
-8 400 올바르지 않은 헤더로 요청한 경우 요청 헤더 확인
-9 400 서비스가 종료된 API를 호출한 경우 공지 메일이나 데브톡 공지 확인
-10 400 허용된 요청 회수를 초과한 경우 쿼터 확인 후 쿼터 범위 내로 호출 조정, 필요시 데브톡으로 제휴 문의
-11 400 일 한도 또는 월 한도 금액을 초과한 유료 API를 호출한 경우 한도 확인 후 한도 금액 상향
-12 403 카카오디벨로퍼스 앱 또는 개발자 계정이 제재된 경우 -
-401 401 유효하지 않은 앱키나 액세스 토큰으로 요청한 경우, 등록된 앱 정보와 호출된 앱 정보가 불일치 하는 경우 앱키 확인 또는 토큰 갱신, 개발자 사이트에 등록된 앱 정보 확인
-501 400 카카오톡 미가입 또는 유예 사용자가 카카오톡 또는 톡캘린더 API를 호출한 경우 -
-602 400 이미지 업로드 시 최대 용량을 초과한 경우 -
-603 400 카카오 플랫폼 내부에서 요청 처리 중 타임아웃이 발생한 경우 -
-606 400 업로드할 수 있는 최대 이미지 개수를 초과한 경우 -
-903 400 등록되지 않은 개발자의 앱키나 등록되지 않은 개발자의 앱키로 구성된 액세스 토큰으로 요청한 경우 -
-911 400 지원하지 않는 포맷의 이미지를 업로드 하는 경우 -
-9798 503 서비스 점검중 -

카카오 로그인

카카오 로그인 기반 일부 API의 경우 앱 연결이 선행되어야 합니다.

에러 코드 상태 코드 원인 해결 방법
-101 400 해당 앱에 카카오계정 연결이 완료되지 않은 사용자가 호출한 경우 카카오계정 연결 후 재시도
-102 400 이미 앱과 연결되어 있는 사용자의 토큰으로 수동 연결을 요청한 경우 -
-103 400 휴면 상태, 또는 존재하지 않는 카카오계정으로 요청한 경우 -
-201 400 사용자 정보 요청 API나 사용자 정보 저장 API 호출 시 앱에 추가하지 않은 사용자 프로퍼티 키 값을 불러오거나 저장하려고 한 경우 앱 관리 페이지의 [카카오 로그인] > [사용자 프로퍼티]에서 설정한 사용자 프로퍼티 키와 요청 파라미터가 일치하도록 설정
-402 403 해당 API에서 접근하는 리소스에 대해 사용자의 동의를 받지 않은 경우 응답본문의 required_scopes을 확인하여 사용자에게 해당 동의항목을 추가 동의 받도록 요청
-406 401 14세 미만 미허용 설정이 되어 있는 앱으로 14세 미만 사용자가 API 호출한 경우 -

카카오톡 메시지

에러 코드 상태 코드 원인 해결 방법
-502 400 받는 이가 보내는 이의 친구가 아닌 경우 카카오톡 친구 목록 조회 API 응답 캐시 만료 시간이 지난 후, 재요청
-530 400 받는 이가 메시지 수신 거부를 설정한 경우 -
-532 400 특정 앱에서 보내는 이가 받는 사람 관계없이 하루 동안 보낼 수 있는 쿼터를 초과한 경우 -
-533 400 특정 앱에서 받는 이가 하루 동안 받을 수 있는 쿼터를 초과한 경우 -
-536 400 '보내는 이와 받는 이' 한 쌍을 기준으로 하루 동안 주고 받을 수 있는 쿼터를 초과한 경우 -

카카오톡 채널

에러 코드 상태 코드 원인 해결 방법
-541 400 존재하지 않는 카카오톡 채널인 경우 -
-544 400 카카오톡 채널이 제재 상태인 경우 -
-815 400 카카오톡 채널 API 내부 에러 -
-816 400 파일 ID가 잘못된 경우나 해당 파일 ID로 업로드된 카카오톡 채널 고객파일을 찾을 수 없는 경우 -
-817 400 이미 존재하는 파일명이나 허용되지 않는 파일명으로 고객파일 등록하는 경우 -
-818 400 등록한 고객파일이 최대 개수를 초과한 경우 (카카오톡 채널 관리자센터에 업로드한 파일 포함하여 최대 30개) -
-819 400 카카오톡 채널과 앱이 연결되지 않은 경우 앱에 카카오톡 채널 연결

푸시 알림

에러 코드 상태 코드 원인 해결 방법
-901 400 등록된 푸시 토큰이 없는 기기로 푸시 메시지를 보낸 경우 -

톡캘린더

에러 코드 상태 코드 원인 해결 방법
-520 400 공개 일정 ID 또는 캘린더 ID가 존재하지 않는 경우 -
-521 400 카카오톡 프로필 스티커에 등록된 할 일을 수정 또는 삭제 시도한 경우 -

카카오모먼트

이 외 응답 코드는 카카오모먼트를 참고합니다.

에러 코드 상태 코드 원인 해결 방법
-813 400 카카오모먼트 API의 내부 에러 -

카카오 키워드광고

이 외 응답 코드는 카카오 키워드광고를 참고합니다.

에러 코드 상태 코드 원인 해결 방법
-820 400 카카오 키워드광고 API의 내부 에러 -
REST API> 에러 코드