에러 코드

아래 목록에 없는 에러 코드 정보는 비즈니스 인증 에러 코드를 참고합니다.

공통 에러 코드

에러 코드	상태 코드	원인	해결 방법
-1	500	시스템 오류가 발생한 경우	-
-2	400	잘못된 파라미터를 전달한 경우 호출 인자값이 잘못되었거나 필수 인자가 포함되지 않은 경우	API 호출 시 파라미터를 확인하고 올바른 값을 전달합니다.
-3	400	지원되지 않는 서비스 API를 호출한 경우 해당 앱의 호출된 API가 설정에서 off되어 있을 경우	앱 관리 페이지에서 API 설정을 확인합니다.
-5	403	해당 API에 대한 권한/퍼미션이 없는 경우	API 사용 권한을 확인합니다.
-10	400	허용된 요청 횟수가 초과된 경우	요청 횟수를 줄이고 재시도합니다.
-12	403	카카오디벨로퍼스 앱 또는 개발자 계정이 제재된 경우	데브톡으로 문의합니다.
-101	400	해당 앱에 연결이 되지 않은 사용자의 요청인 경우 로그인 기반 API의 경우 앱 연결이 선행되어야 함	사용자가 앱에 연결되어 있는지 확인합니다.
-402	403	해당 API 요청에 필요한 비즈니스 동의항목의 사용자 동의를 받지 않은 경우 응답 내 required_scope(s) 항목을 사용자에게 추가 동의 요청 필요	사용자에게 필요한 동의항목에 대한 추가 동의를 요청합니다. 참고: 비즈니스 동의항목
-820	400	카카오 키워드광고 내부 에러가 있을 경우	-
-813	429	사용량 제한(쿼터)을 초과한 경우	쿼터 사용량을 확인하고 재시도합니다.

예제

HTTP/1.1 400 Bad request
Content-Type: application/json;charset=UTF-8
{
  "code": -820,
  "msg": "KakaoKeywordAdException",
  "extras": {
    "detailCode": 103005,
    "detailMsg": "없는 비즈채널입니다."
  }
}

상세 에러 코드(detailCode)

코드	설명
400	Bad Request
403	Forbidden
404	Not Found
409	Conflict
100000	유효하지 않은 URL 형식입니다.
100001	비즈채널의 URL에 적합하지 않은 랜딩 URL입니다.
101001	비즈채널 카테고리를 입력하세요.
101002	비즈채널 이름이 이미 사용 중 입니다.
101003	비즈채널 이름이 올바르지 않습니다.
101004	비즈채널 이름은 1 ~ 12자로 해주세요.
101010	비즈채널 검수계정 아이디 또는 비밀번호를 입력하세요.
101012	비즈채널이 존재하지 않습니다.
101014	비즈채널에 캠페인이 존재합니다.
101015	등록 가능한 톡 채널 수를 넘었습니다.
101016	심사 서류 ID가 올바르지 않습니다.
101017	이미 등록된 톡 채널입니다.
101019	비즈채널 최대갯수 초과입니다.
101020	PC 또는 모바일 사이트를 입력하세요.
101024	비즈채널의 URL 설정 체계에 정상적으로 입력하세요.
102003	카카오톡 채널 프로필 ID를 정상적으로 입력하세요.
102005	URL은 최대 1,000자까지 입력가능합니다
103000	캠페인 유형에 유효하지 않은 비즈채널입니다.
103001	캠페인 최대갯수 초과입니다.
103002	캠페인 이름 중복입니다.
103003	캠페인 이름 길이 초과 또는 미만입니다.
103004	캠페인 일예산 초과 또는 미만입니다.
103005	없는 비즈채널입니다.
103006	비즈채널 권한이 없습니다.
103007	Pixel&SDK 권한이 없습니다.
104000	제외키워드는 100개까지 등록 가능합니다.
104001	일예산을 지정했을 경우, 최소 1,000원, 최대 10,000,000원 범위 내에서 10원 단위로 등록 가능합니다.
104002	캠페인당 광고그룹은 최대 1000개까지만 등록이 가능합니다.
104003	같은 캠페인 내에 중복된 이름의 광고그룹이 존재합니다.
104004	광고그룹명은 최소 1자, 최대 50자까지 입력 가능합니다.
104005	해당 캠페인이 존재하지 않습니다.
104007	이미 삭제된 그룹입니다.
104012	제외 키워드는 1자 이상 50자 이하여야 합니다.
104100	기본입찰가는 최소 70원, 최대 100,000원 범위 내에서 10원 단위로 등록 가능합니다.
104101	콘텐츠 매체 입찰가 선택시, 입찰가는 최소 70원, 최대 100,000원 범위 내에서 10원 단위로 등록 가능합니다.
104102	PC 입찰 가중치는 최소 10%, 최대 500% 범위 내에서 등록 가능합니다.
104103	모바일 입찰 가중치는 최소 10%, 최대 500% 범위 내에서 등록 가능합니다.
104104	키워드 확장 입찰 가중치는 최소 10%, 최대 500% 범위 내에서 등록 가능합니다.
104200	노출 종료날짜 선택시, 종료날짜는 시작날짜를 앞서서 등록할 수 없습니다.
104201	광고가 노출될 수 있는 스케쥴을 최소 1개 이상 등록해야 합니다.
104202	필수 파라미터를 정상적으로 입력하세요.
104203	오늘 이전의 날짜는 등록할 수 없습니다.
105000	이미 삭제된 키워드입니다.
105001	키워드는 1자 이상 50자 이하여야 합니다.
105002	키워드는 한글, 영문, 숫자만 가능합니다.
105004	그룹당 최대 1000개의 키워드를 등록할 수 있습니다.
105005	등록 키워드를 1개이상 입력하셔야 합니다.
105006	구매 불가능한 키워드가 포함되어있습니다. $입력값
105010	키워드가 존재하지 않습니다.
105100	고정입찰가는 최소 70원, 최대 100,000원 범위 내에서 10원 단위로 등록 가능합니다.
105200	유효하지 않은 키워드 랜딩 URL입니다.
105202	키워드 랜딩 URL은 심사중에 수정할 수 없습니다.
106000	소재에 유효하지 않은 비즈채널입니다.
106002	소재 이름 중복입니다.
106003	소재 이름 길이 초과 또는 미만입니다.
106007	심사 서류가 유효하지 않습니다.
106100	타이틀 길이 초과 또는 미만입니다.
106101	설명 길이 초과 또는 미만입니다.
106102	추가제목 길이 초과 또는 미만입니다.
106103	부가링크 갯수 초과 또는 미만입니다.
106104	부가링크 설명 길이 초과 또는 미만입니다.
106105	말머리 길이 초과 또는 미만입니다.
106107	가격테이블 설명 길이 초과 또는 미만입니다.
106201	이미지 설명문구 길이 초과 또는 미만입니다.
106202	썸네일 이미지 사이즈가 아닙니다.
106300	잘못된 전화번호 형식입니다.
106301	해당 업종은 계산하기 URL을 사용할 수 없습니다.
106401	톡채널이 유효하지 않습니다.
108001	그룹당 최대 20개의 소재를 등록할 수 있습니다.
108002	이미 그룹에 존재하는 소재를 다시 등록할 수 없습니다.
108003	소재의 비즈채널이 광고그룹의 비즈채널과 맞지 않습니다.
110003	맞춤보고서 기간 설정이 유효하지 않습니다.
110004	맞춤보고서 분석항목이 유효하지 않습니다.
110005	톡채널검색의 키워드 상세보고서는 추후 제공 예정입니다.
112003	이미지 관리에 없는 이미지 입니다.
112004	해당 이미지는 이미 삭제되었습니다.
112005	해당 이미지를 소유하고 있지 않습니다.
401001	450x450, 400KB, JPG/JPEG/PNG 파일만 지원합니다.
402001	10MB,JPG,JPEG,GIF,PNG,TIF,HWP,DOC,DOCX,PDF 파일만 지원합니다.
403001	허용되지 않은 파일 경로입니다.