service | isSuccess | resultCode | resultMessage |
---|---|---|---|
공통 | true | 0 | 성공 |
공통 | false | 4 | 파라미터 유효성 검증 실패(resultMessage 참고) |
공통 | false | -1000 | 유효하지 않은 앱키 |
공통 | false | -1001 | 유효하지 않은 비밀 키(secretKey) |
공통 | false | -1002 | 유효하지 않은 SMS 앱키 |
공통 | false | -1003 | 유효하지 않은 SMS 발신 번호 |
공통 | false | -1004 | 이미 등록된 발신프로필 |
공통 | false | -1005 | 10분간 동일한 X-NC-API-IDEMPOTENCY-KEY 값으로 메시지 발송을 요청한 경우 |
공통 | false | -1008 | 발신프로필 토큰 등록 실패 |
공통 | false | -1010 | 발신프로필 그룹이 존재하지 않을 경우 |
공통 | false | -1013 | 이미 존재하는 발신프로필 그룹일 경우 |
공통 | false | -1014 | 활성화 되지 않은 발신프로필일 경우 |
공통 | false | -1016 | 메시지를 찾을 수 없을 경우 |
공통 | false | -1017 | 일별 발송량을 초과한 발송 실패 |
공통 | false | -1018 | 이미 발신프로필 그룹에 등록된 경우 |
공통 | false | -1019 | 유효하지 않은 대체 발송 080수신거부 번호 |
공통 | false | -1022 | 발신프로필이 그룹에 등록되지 않은 발신프로필일 경우 |
공통 | false | -1023 | 발신프로필이 그룹이 최대 10개가 초과한 경우 |
공통 | false | -1024 | 발신프로필이 그룹으로 메시지를 발송할 경우 |
공통 | false | -1025 | 발신프로필 삭제 API로 발신프로필 그룹 삭제 시도한 경우 |
공통 | false | -1026 | 발신프로필 그룹의 멤버가 5000개가 초과한 경우 |
공통 | false | -1027 | 발신프로필이 차단 상태일 경우 |
공통 | false | -1028 | 템플릿 변수가 치환될 때 그 차이가 14개 글자를 초과하는 부분이 있는 경우(최초 사용자 제한) |
공통 | false | -1029 | 그룹 프로필에 멤버로 추가할 수 없는 경우(최초 사용자 제한) |
공통 | false | -1030 | 본인인증을 받지 않은 경우 |
공통 | false | -2000 | 특정 필드값이 최대 길이 초과할 경우 |
공통 | false | -2001 | 특정 필드값이 필수 값이 공백인 경우 |
공통 | false | -2002 | 특정 필드값이 NULL일 경우 |
공통 | false | -2003 | 특정 필드값이 최소 길이보다 작을 경우 |
공통 | false | -2017 | 존재하지 않는 발신프로필 |
공통 | false | -2018 | 유효하지 않은 버튼 파라미터 |
공통 | false | -2019 | 템플릿 본문 1,000글자 초과로 실패 |
공통 | false | -2022 | 이미지를 첨부하였는데 이미지링크(imageLink)를 입력하지 않은 경우 |
공통 | false | -2023 | 친구톡 메시지 본문이 400글자 초과할 경우(이미지 첨부) |
공통 | false | -2024 | 친구톡 메시지 본문이 1,000글자 초과할 경우 |
공통 | false | -2025 | 예약 일시가 과거의 일시일 경우 |
공통 | false | -2026 | 예약 일시가 90일 이후의 일시일 경우(최대 90일까지 가능) |
공통 | false | -2027 | 날짜 포맷이 달라 파싱 오류 발생 |
공통 | false | -2028 | 유효하지 않은 요청 ID |
공통 | false | -2029 | 요청한 메시지가 없거나, 취소할 수 있는 메시지가 없는 경우 |
공통 | false | -2030 | 와이드 이미지 발송 시, 최대 본문 길이 76자 초과한 경우 |
공통 | false | -2031 | 와이드 이미지 발송 시, 최대 버튼 개수 2개 초과한 경우 |
공통 | false | -2032 | 템플릿 제목이 50자를 초과한 경우 |
공통 | false | -2033 | 템플릿 아이템 파라미터가 유효하지 않은 경우 |
공통 | false | -2034 | 템플릿 아이템 하이라이트 파라미터가 유효하지 않은 경우 |
공통 | false | -2035 | 템플릿 헤더가 16자를 초과한 경우 |
공통 | false | -2036 | TemplateRepresentLink 파라미터가 유효하지 않은 경우 |
공통 | false | -2037 | 아이템 리스트 포함 템플릿 등록 시 메시지 본문 글자 수가 700자를 초과한 경우 |
공통 | false | -2500 | 대량 발송 요청을 찾을 수 없는 경우 |
공통 | false | -2501 | 요청한 메시지가 없거나, 취소할 수 있는 메시지가 없는 경우 |
공통 | false | -2502 | 발송 실패 설정이 되어 있지 않고, 대체 발송을 요청했을 경우 |
공통 | false | -2504 | 유효하지 않은 바로연결 |
공통 | false | -2505 | 바로연결 포함 발송 시, 최대 버튼 개수 2개를 초과한 경우 |
공통 | false | -2999 | 발송 요청한 모든 수신자 요청 실패 |
공통 | false | -3000 | 웹 링크(WL) 버튼 타입의 템플릿일 경우, linkMo 필수 필드 |
공통 | false | -3001 | 이미 존재하는 템플릿 코드 또는 템플릿명 |
공통 | false | -3002 | 필요한 요청 본문(request body) 내용을 읽을 수 없을 경우 |
공통 | false | -3003 | 존재하는 않는 템플릿 |
공통 | false | -3004 | 발송할 템플릿 파라미터 오류 |
공통 | false | -3005 | 템플릿 상태 오류(승인 전 발송 요청 시) |
공통 | false | -3006 | 버튼 URL은 반드시 http:// 또는 https://를 포함해야 합니다. |
공통 | false | -3007 | 자유 버튼 타입의 템플릿만 버튼명과 버튼 URL 입력 가능합니다. |
공통 | false | -3008 | 배송 조회 버튼 타입은 버튼 URL을 입력할 수 없습니다. |
공통 | false | -3009 | 버튼명이 존재하지 않습니다. |
공통 | false | -3010 | 등록한 템플릿 본문과 일치하지 않는 경우 |
공통 | false | -3011 | 등록한 템플릿 버튼과 일치하지 않는 경우 |
공통 | false | -3012 | 수정할 수 없는 템플릿 상태(승인/반려 상태만 가능) |
공통 | false | -3013 | 이미 수정 중인 템플릿이 존재 |
공통 | false | -3014 | 버튼 타입이 올바르지 않은 경우 |
공통 | false | -3015 | CBT 기능이 비활성화된 플러스친구일 경우 |
공통 | false | -3016 | 강조 표기형 템플릿은 templateTitle, templateSubtitle 필수 필드 |
공통 | false | -3017 | templateSubtitle 은 치환 변수를 사용 불가 |
공통 | false | -3018 | 부가 정보형 템플릿은 templateExtra 필수 필드 |
공통 | false | -3020 | 복합형 템플릿은 templateExtra, templateAd 필수 필드 |
공통 | false | -3021 | templateExtra은 치환 변수를 사용 불가 |
공통 | false | -3024 | AC 타입 버튼은 채널 추가형 복합형 템플릿만 등록 가능 |
공통 | false | -3025 | AC 타입 버튼은 단독으로 사용하거나, 가장 위에 위치해야하는 제약에 어긋난 경우 |
공통 | false | -3026 | AC 타입 버튼의 이름은 "채널 추가" 만 등록 가능 |
공통 | false | -3027 | 템플릿 강조 표시 타입 기본(NONE)로 등록 시, templateTitle, templateSubtitle 필드를 등록할 수 없음 |
공통 | false | -3028 | 템플릿 메시지 유형 기본형(BA)일 경우, templateExtra 필드를 등록할 수 없음 |
공통 | false | -3030 | 템플릿 메시지 유형 채널 추가형(AD)일 경우, templateExtra 필드를 등록할 수 없음 |
공통 | false | -3032 | 템플릿 강조 표시 타입 이미지형(IMAGE)일 경우, templateImageName, templateImageUrl 필드 필수값 |
공통 | false | -3033 | 버튼 또는 바로연결이 템플릿에 등록되지 않았을 경우 |
공통 | false | -3034 | 삭제할 템플릿이 3일이내 발송 이력이 있을 경우 |
공통 | false | -3035 | 템플릿 강조 표시 타입 아이템리스트형(ITEM_LIST)로 등록 시, templateHeader, templateImageName, templateImageUrl, templateItem, templateItemHighlight 필드 중 1개 이상 필수로 포함 |
공통 | false | -3036 | 템플릿 강조 표시 타입 아이템리스트형(ITEM_LIST)로 등록 시, 보안 템플릿으로 등록할 수 없음 |
공통 | false | -3037 | templateItem list의 title은 치환 변수를 가질 수 없음 |
공통 | false | -3038 | templateItem summary의 title은 치환 변수를 가질 수 없음 |
공통 | false | -3039 | templateItem summary은 templateItem list없이 존재할 수 없음 |
공통 | false | -3040 | 아이템하이라이트의 title은 최대 21글자, description은 최대 13글자 |
공통 | false | -3041 | imageUrl은 http:// https:// 프로토콜을 반드시 포함해야 함 |
공통 | false | -3042 | templateHeader이 템플릿과 일치하지 않는 경우 |
공통 | false | -3043 | templateItem 또는 templateItemHighlight이 템플릿과 일치하지 않는 경우 |
공통 | false | -3044 | 비지니스폼(BF) 타입 버튼은 단독으로 사용하거나, 가장 위에 위치해야하는 제약에 어긋난 경우 |
공통 | false | -3045 | 비지니스폼(BF) 타입의 name이 "톡에서 예약하기", "톡에서 설문하기", "톡에서 응모하기" 이 아닐 경우, 또는 등록되지 않은 bizFormKey일 경우 |
공통 | false | -3046 | templateRepresentLink이 템플릿과 일치하지 않는 경우 |
공통 | false | -3047 | 템플릿 등록시 서체 스타일을 적용하려고 한 경우 (서체 스타일은 발송 시점에 적용 가능합니다.) |
공통 | false | -3048 | 템플릿 파라미터는 1000자를 넘을 수 없습니다. |
공통 | false | -3100 | 템플릿 요청/승인 상태의 경우 comment를 추가할 수 없음 |
공통 | false | -3101 | 바로 연결 이름이 존재하지 않는 경우 |
공통 | false | -3102 | 바로 연결은 치환자를 포함할 수 없음 |
공통 | false | -3103 | 버튼 혹은 바로 연결의 형식이 올바르지 않은 경우 (json 형식이 아니거나, escape 되지 않은 문자가 섞여있음) |
공통 | false | -3200 | 와이드 아이템리스트에 name이 누락된 경우 |
공통 | false | -3201 | 와이드 아이템리스트에 image가 누락된 경우 |
공통 | false | -3202 | 와이드 아이템리스트에 linkMo가 누락된 경우 |
공통 | false | -3203 | 와이드 아이템리스트는 3~4개의 크기의 list와 header가 필수적 |
공통 | false | -3204 | 캐러셀에 header가 누락된 경우 |
공통 | false | -3205 | 캐러셀에 message가 누락된 경우 |
공통 | false | -3206 | 캐러셀에 attachment가 누락된 경우 |
공통 | false | -3207 | 캐러셀에 image가 누락된 경우 |
공통 | false | -3208 | 캐러셀에 2~10개의 크기의 list가 필수, 인트로를 포함한 캐러셀 커머스형의 경우 1~10개의 크기의 list가 필수 |
공통 | false | -3209 | 캐러셀의 tail에 linkMo가 누락된 경우 |
공통 | false | -3210 | 쿠폰은 title과 description이 필수적 |
공통 | false | -3211 | 친구톡 텍스트/이미지 타입 친구톡 메시지의 경우 쿠폰의 description은 12자를 초과할 수 없고, FW/FL 타입의 경우 18자를 초과할 수 없음 |
공통 | false | -3212 | 쿠폰의 title 내용이 유효하지 않은 경우 |
공통 | false | -3213 | 쿠폰은 모바일 링크 혹은 채널형 ios/android 링크가 필수적 |
공통 | false | -3215 | 와이드 아이템리스트와 캐러셀은 광고 타입일 경우에만 사용 가능 |
공통 | false | -3216 | 와이드 아이템리스트의 첫번째 아이템 title은 25자를 초과할 수 없고, 2 ~ 4 번째 아이템 title은 30자를 초과할 수 없음 |
공통 | false | -3217 | 친구톡 텍스트/이미지 타입의 경우 버튼은 5개를 초과할 수 없고, 쿠폰이 포함된 경우 4개를 초과할 수 없음, 와이드 이미지/와이드 아이템 리스트인 경우 버튼은 2개를 초과할 수 없음, 프리미엄 동영상 타입의 경우 버튼은 1개를 초과할 수 없음, 커머스형의 경우 버튼은 1 ~ 2개 사이여야 함 |
공통 | false | -3218 | 친구톡 videoUrl이 유효하지 않음 |
공통 | false | -3219 | 친구톡 content 최대 길이를 초과함. 프리미엄 동영상 타입의 경우 content 최대 길이가 76자 |
공통 | false | -3220 | 친구톡 header 최대 길이를 초과함. 프리미엄 동영상 타입의 경우 header 최대 길이가 20자 |
공통 | false | -3221 | 캐러셀 피드 타입은 캐러셀 인트로를 사용할 수 없음 |
공통 | false | -3222 | 캐러셀 피드 타입은 부가 정보 필드를 사용할 수 없음 |
공통 | false | -3223 | 캐러셀 피드 타입은 커머스를 사용할 수 없음 |
공통 | false | -3224 | 캐러셀 커머스 타입은 header와 message 필드를 사용할 수 없음 |
공통 | false | -3225 | 캐러셀 버튼이 유효하지 않음. 캐러셀 피드 타입의 경우 버튼은 2개를 초과할 수 없음. 캐러셀 커머스 타입의 경우 버튼은 1 ~ 2개여야 함 |
공통 | false | -3226 | 커머스에 discountPrice 필드가 존재하면 discountRate 혹은 discountFixed 필드가 필수 |
공통 | false | -4003 | 조회 범위는 한 달 초과 |
공통 | false | -4004 | 존재하지 않는 앱키 |
공통 | false | -4005 | 사용 종료 상태의 앱키 |
공통 | false | -4007 | 파일 사이즈 초과 초과 |
공통 | false | -4009 | 유효하지 않은 파일 확장자 |
공통 | false | -4015 | 유효하지 않은 요청 ID(requestId) |
공통 | false | -4025 | 템플릿 업로드 시, 최대 20개를 초과한 경우 |
공통 | false | -4026 | 템플릿 업로드 파일의 헤더가 유효하지 않은 경우 |
공통 | false | -4027 | 버튼 길이가 최대치인 상태로 채널 추가형 전환을 하려고 하는 경우 |
공통 | false | -4028 | 승인되지 않은 템플릿으로 채널 추가형 전환을 하려고 하는 경우 |
공통 | false | -4101 | 유효하지 않은 통계 조회 파라미터 |
공통 | false | -4103 | 조회 시, 발송 요청 시작 시간/발송 요청 끝 시간값이 없을 경우 |
공통 | false | -4200 | 유효하지 않은 대체 발송 메시지 |
공통 | false | -5000 | 유효하지 않은 수신 번호 |
공통 | false | -6000 | 고정형(F) 내용 유형은 변수를 포함할 수 없음 |
공통 | false | -6001 | 변수형(V) 내용 유형은 반드시 변수를 포함해야 함 |
공통 | false | -6002 | 변수는 총 20개 이상 포함할 수 없음 |
공통 | false | -6003 | 변수는 영문/숫자/특수문자('-', '')만 사용할 수 있으며 20자 이내로만 가능 |
공통 | false | -6004 | 와이드형(W) 메시지 타입은 본문 76자 이내, 버튼 2개까지 가능 |
공통 | false | -6005 | 채널 추가(AC) 타입 버튼은 이미지형(I) 메시지 타입일 경우, 첫 번째 순서에 위치해야 합니다. 와이드형(W) 메시지 타입일 경우, 마지막에 위치해야 합니다. |
공통 | false | -6006 | 비지니스폼(BF) 타입 버튼은 bizFormId 값이 반드시 존재해야 합니다. 이미지형(I) 메시지 타입일 경우, 첫 번째 순서에 위치해야 합니다. 와이드형(W) 메시지 타입일 경우, 마지막에 위치해야 합니다. 이미지형(I) 메시지 타입이면서 채널 추가(AC) 타입 버튼과 같이 사용할 경우, 두 번째에 위치해야 합니다. 와이드형(W) 메시지 타입이면서 채널 추가(AC) 타입 버튼과 같이 사용할 경우, 첫 번째에 위치해야 합니다. |
공통 | false | -6007 | 080 수신거부 번호 유효성 검사 실패 |
공통 | false | -7000 | 벤더 요청 API 실패 |
공통 | false | -8000 | 이미지 시퀀스(imageSeq)가 없는 경우 |
공통 | false | -8001 | 이미지 파일이 정상적이지 않은 경우 |
공통 | false | -8002 | 이미지를 찾을 수 없는 경우. 캐러셀 피드 타입의 경우 캐러셀 타입 이미지를 사용해야 함, 캐러셀 커머스 유형의 경우 캐러셀 커머스 타입 이미지를 사용해야 함, 커머스 유형의 경우 일반 이미지 타입을 사용해야 함 |
공통 | false | -8003 | 이미지 삭제에 실패하는 경우 |
공통 | false | -8004 | createUser 필드 최대 100자를 초과한 경우 |
공통 | false | -8005 | 이미지 업로드 시 프로젝트에 등록된 플러스친구가 없는 경우 |
공통 | false | -8006 | 인증 메시지 발송 시, 템플릿 내용에 인증 문구가 없는 경우 |
공통 | false | -8008 | 메시지 내용에 금칙어가 포함된 경우 |
공통 | false | -8010 | 네트워크 등의 문제로 이미지 파일 업로드 실패 |
공통 | false | -9995 | fade-out된 버전의 API를 호출했을 경우 |
공통 | false | -9996 | Content-type이 application/json가 아닐 경우 |
공통 | false | -9997 | 적절하지 않은 요청으로 인한 실패 |
공통 | false | -9998 | 존재하지 않는 API |
공통 | false | -9999 | 시스템 오류 |
코드값 | 의미 |
---|---|
1000 | 성공 |
1001 | Request Body가 Json형식이 아님 |
1002 | 허브 파트너 키가 유효하지 않음 |
1003 | 발신 프로필 키가 유효하지 않음 |
1004 | Request Body(JSON)에서 name을 찾을 수 없음 |
1006 | 삭제된 발신 프로필(고객센터에게 문의) |
1007 | 차단 상태의 발신 프로필(고객센터에게 문의) |
1011 | 계약 정보를 찾을 수 없음(고객센터에게 문의) |
1012 | 잘못된 형식의 사용자키 요청 |
1013 | 유효하지 않은 앱 연결 |
1014 | 유효하지 않은 사업자번호 |
1015 | 유효하지 않은 app user id 요청 |
1016 | 사업자등록번호 불일치 |
1020 | 전화번호 or app user id가 유효하지 않거나 미입력 요청 |
1021 | 차단 상태의 카카오톡 채널 |
1022 | 닫힘 상태의 카카오톡 채널 |
1023 | 삭제된 카카오톡 채널 |
1024 | 삭제 대기 상태의 카카오톡 채널 |
1025 | 채널 제재 상태로 인한 메시지 전송 실패 |
1027 | 채널 메시지 제재 상태로 인한 메시지 전송 실패 |
1030 | 잘못된 파라미터 요청 |
2001 | 메시지 전송 불가(예기치 않은 오류 발생) |
2003 | 메시지 전송 실패(테스트 서버에서 카카오톡 채널을 추가하지 않은 경우) |
3000 | 예기치 않은 오류 발생 |
3005 | 메시지를 발송했으나 수신 확인이 안 됨(성공 불확실, 서버에는 암호화되어 보관되며 3일 이내 수신 가능) |
3006 | 내부 시스템 오류로 메시지 전송 실패 |
3008 | 전화번호 오류 |
3010 | 예기치 않은 오류 발생 |
3011 | 메시지가 존재하지 않음 |
3012 | 카카오 통신 실패 |
3013 | 메시지가 비어 있음 |
3014 | 메시지 길이 제한 오류 |
3015 | 템플릿을 찾을 수 없음 |
3016 | 메시지 내용이 템플릿과 일치하지 않음 |
3018 | 메시지를 전송할 수 없음 1. 카카오톡 사용했었다가 탈퇴한사람 2. 카카오톡 가입한적이 한번도 없는 사람 3. 알림톡 수신차단 4. 안드로이드 사용자의경우, "핸드폰 유심과 카카오톡 사용번호"가 다른 사람 5. 활성 사용자가 아닌 경우 활성 사용자란? * 서버와 연결되어 있는 카카오톡 사용자 * 발송 당일 가입한 사용자를 제외한 최근 7일(168시간) 내에 카카오톡을 사용한 사용자 6. 카카오톡 최소 사용버전 및 카톡 미지원, 제재 사용자 등 |
3022 | 발송 가능한 시간이 아님(친구톡 메시지는 08시부터 20시 50분까지 발송 가능) |
3023 | 메시지 문법 오류(JSON 형식 오류) |
3024 | 메시지에 포함된 이미지를 전송할 수 없음(이미지주소 또는 링크가 올바르지 않거나 이미지가 규격에 맞지 않음) |
3025 | 변수 글자 수 제한 초과 |
3026 | 상담/봇 전환 버튼 extra, event 글자수 제한 초과 |
3027 | 메시지 버튼/바로연결이 템플릿과 일치하지 않음 |
3028 | 메시지 강조 표기 타이틀이 템플릿과 일치하지 않음 |
3029 | 메시지 강조 표기 타이틀 길이 제한 초과(50자) |
3030 | 메시지 타입과 템플릿 강조유형이 일치하지 않음 |
3031 | 헤더가 템플릿과 일치하지 않음 |
3032 | 헤더 길이 제한 초과(16자) |
3033 | 아이템 하이라이트가 템플릿과 일치하지 않음 |
3034 | 아이템 하이라이트 타이틀 길이 제한 초과(이미지 없는 경우 30자, 이미지 있는 경우 21자) |
3035 | 아이템 하이라이트 디스크립션 길이 제한 초과(이미지 없는 경우 19자, 이미지 있는 경우 13자) |
3036 | 아이템 리스트가 템플릿과 일치하지 않음 |
3037 | 아이템 리스트의 아이템의 디스크립션 길이 제한 초과(23자) |
3038 | 아이템 요약정보가 템플릿과 일치하지 않음 |
3039 | 아이템 요약정보의 디스크립션 길이 제한 초과(14자) |
3040 | 아이템 요약정보의 디스크립션에 허용되지 않은 문자 포함(통화기호/코드, 숫자, 콤마, 소수점, 공백을 제외한 문자 포함) |
3041 | 와이드 아이템 리스트 갯수 최대 최소 갯수 불일치 |
3042 | 대표링크가 템플릿과 일치하지 않음 |
3046 | 부가 정보 최대 길이 제한 오류 |
3047 | 커머스 정보 상품명 최대 길이 제한 오류 |
3048 | 유효하지 않은 그룹 태그 키 입력 |
3051 | 케러셀 아이템 리스트 갯수 최소, 최대 갯수 불일치 |
3052 | 케러셀 아이템 메시지 길이 초과 |
3056 | 와이드 아이템 리스트 타이틀 길이 제한 오류 |
3058 | 캐러셀 헤더 길이 제한 오류 |
4000 | 메시지 전송 결과를 찾을 수 없음 |
4001 | 알 수 없는 메시지 상태 |
9998 | 시스템에 문제가 발생하여 담당자가 확인 중(현재 서비스 제공 중이 아님) |
9999 | 시스템에 문제가 발생하여 담당자가 확인 중(시스템에 알 수 없는 오류 발생) |