이 문서는 카카오톡 채널 API 이용 중 발생할 수 있는 주요 에러와 해결 방법을 안내합니다. 이 외에 에러 코드는 공통 에러 코드를 참고합니다.
도메인이 kapi.kakao.com
인 카카오톡 채널 API를 호출할 때 발생하는 에러 목록입니다. (참고: 응답 형식)
에러 코드 | 상태 코드 | 원인 | 해결 방법 |
---|---|---|---|
-541 |
400 |
존재하지 않는 카카오톡 채널인 경우 | - |
-544 |
400 |
카카오톡 채널이 제재 상태인 경우 | - |
-815 |
400 |
카카오톡 채널 API 내부 에러 | - |
-816 |
400 |
파일 ID가 잘못된 경우나 해당 파일 ID로 업로드된 카카오톡 채널 고객파일을 찾을 수 없는 경우 | - |
-817 |
400 |
이미 존재하는 파일명이나 허용되지 않는 파일명으로 고객파일 등록하는 경우 | - |
-818 |
400 |
등록한 고객파일이 최대 개수를 초과한 경우 (카카오톡 채널 관리자센터에 업로드한 파일 포함하여 최대 30개) | - |
-819 |
400 |
카카오톡 채널과 앱이 연결되지 않은 경우 | 앱에 카카오톡 채널 연결 |
Kakao SDK를 통해 카카오톡 채널 추가 API 호출 시 발생하는 에러 목록입니다.
에러 코드 | 원인 | 해결 방법 |
---|---|---|
KAE001 |
서버 내부에서 처리 중 에러가 발생한 경우 | 재시도 |
KAE003 |
잘못된 파라미터로 요청한 경우 | 요청 파라미터 확인 |
KAE004 |
유효 시간이 만료된 경우 | 사용자에게 에러 원인과 재시도 필요 안내 |
KAE005 |
조회가 불가능한 상태(잘못된 채널 프로필 ID 또는 요청 수행 불가)의 채널 정보로 요청한 경우 | 올바른 채널 정보로 재요청 |
KAE006 |
친구 추가가 불가능한 상태(비공개, 잠금 등)의 채널 정보로 요청한 경우 | 채널 상태 확인 후 올바른 정보로 재요청 |
KAE007 |
지원하지 않는 환경에서 요청한 경우 | 사용자에게 에러 원인 안내 |
KAE104 |
잘못된 앱 키로 요청한 경우 | 앱 관리 페이지의 [앱] > [일반] > [앱 키]에서 확인한 올바른 플랫폼의 앱 키로 재요청 |
KAE105 |
앱과 연결되지 않은 채널 정보로 요청한 경우 | 앱에 카카오톡 채널 연결 후 재요청 |
KAE108 |
카카오디벨로퍼스 앱 또는 개발자 계정이 제재된 경우 | 데브톡으로 문의합니다. |
KAE201 |
유효하지 않은 액세스 토큰으로 요청한 경우 | 액세스 토큰 재발급 후 재요청 |