사이드 메뉴
시작하기
로그인
커뮤니케이션
광고
카카오톡 채널
에러 코드
이 문서는 카카오톡 채널 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 | 유효하지 않은 액세스 토큰으로 요청한 경우 | 액세스 토큰 재발급 후 재요청 |