에러코드
API 연동에서는 요청 시점의 접수코드와 비동기 리포트 코드를 함께 확인해야 정확한 상태를 판단할 수 있습니다.
코드 원인과 해결 방향을 바로 확인해보세요
응답 코드나 리포트 코드를 검색하면 의미, 원인, 확인 포인트를 코드 분석기에서 빠르게 확인할 수 있습니다.
접수코드
발송 요청 시점에 반환되는 코드입니다.
공통부
게이트웨이의 인증, 권한, 요청 형식 검증 단계 코드입니다.
| Code | Text | Category | Description | Korean Description |
|---|---|---|---|---|
| A000 | SUCCESS | Success | HTTP 2XX or application success | 성공 - 요청이 정상적으로 처리됨 |
| A100 | Failed | Application Error | General failure | 실패 - 일반적인 처리 실패 |
| A301 | Moved Permanently | 3XX Redirection | Permanent redirect | 영구 이동 - 페이지가 다른 주소로 완전히 이동됨 |
| A302 | Found | 3XX Redirection | Found | 찾음 - 페이지가 임시로 다른 위치에 있음 |
| A303 | See Other | 3XX Redirection | See other location | 다른 곳 보기 - 다른 페이지를 확인해야 함 |
| A304 | Not Modified | 3XX Redirection | Not modified | 수정되지 않음 - 요청한 내용이 변경되지 않음 |
| A307 | Temporary Redirect | 3XX Redirection | Temporary redirect | 임시 이동 - 페이지가 일시적으로 다른 곳에 있음 |
| A308 | Permanent Redirect | 3XX Redirection | Permanent redirect | 영구 이동 - 페이지가 영구적으로 다른 곳으로 이동됨 |
| A400 | Bad Request | 4XX Client Error | Invalid request | 잘못된 요청 - 요청 형식이 잘못됨 |
| A401 | Unauthorized | 4XX Client Error | Authentication required | 인증 필요 - 로그인이 필요함 |
| A403 | Forbidden | 4XX Client Error | Access forbidden | 접근 금지 - 권한이 없어 접근할 수 없음 |
| A404 | Not Found | 4XX Client Error | Resource not found | 찾을 수 없음 - 요청한 페이지나 파일이 존재하지 않음 |
| A405 | Method Not Allowed | 4XX Client Error | HTTP method not allowed | 허용되지 않은 방법 - 사용한 요청 방식이 지원되지 않음 |
| A406 | Not Acceptable | 4XX Client Error | Not acceptable | 허용되지 않음 - 요청한 형식을 처리할 수 없음 |
| A407 | Proxy Authentication Required | 4XX Client Error | Proxy authentication required | 프록시 인증 필요 - 중간 서버를 통한 인증이 필요함 |
| A413 | Request Entity Too Large | 4XX Client Error | Request payload too large | 요청이 너무 큼 - 전송하려는 데이터가 너무 큼 |
| A414 | Request URI Too Long | 4XX Client Error | Request URI too long | 주소가 너무 김 - 요청한 주소가 너무 길어서 처리할 수 없음 |
| A415 | Unsupported Media Type | 4XX Client Error | Unsupported media type | 지원되지 않는 파일 형식 - 업로드한 파일 형식이 지원되지 않음 |
| A500 | Internal Server Error | 5XX Server Error | Internal server error | 서버 내부 오류 - 서버에서 처리 중 오류가 발생함 |
| A501 | Not Implemented | 5XX Server Error | Feature not implemented | 구현되지 않음 - 요청한 기능이 아직 개발되지 않음 |
| A502 | Bad Gateway | 5XX Server Error | Bad gateway | 잘못된 게이트웨이 - 중간 서버에 문제가 있음 |
| A503 | Service Unavailable | 5XX Server Error | Service unavailable | 서비스 사용 불가 - 서버가 일시적으로 사용할 수 없음 |
| A504 | Gateway Timeout | 5XX Server Error | Gateway timeout | 게이트웨이 시간 초과 - 중간 서버 응답이 너무 늦음 |
| A511 | Network Authentication Required | 5XX Server Error | Network authentication required | 네트워크 인증 필요 - 네트워크 레벨에서 인증이 필요함 |
개별부
상품 API 비즈니스 로직 처리 단계의 코드입니다.
| Http Status | Code | Result | Description |
|---|---|---|---|
| 200 | A000 | Success | 요청 성공 |
| 401 | A001 | Expired token | 만료된 토큰 |
| 403 | A002 | Invalid token | 토큰 권한 없음 |
| 400 | A010 | Cannot parse JSON | JSON을 파싱 할 수 없음 |
| 400 | A011 | Cannot mapping JSON | JSON을 매핑 할 수 없음 |
| 429 | A020 | Number of 'Ratelimit' exceeded | Ratelimit(TPS) 초과 |
| 500 | A910 | Internal server error | Internal server error |
| 503 | A920 | Server busy | 서비스 처리 일시적 불가 |
| 500 | A999 | Unknown error | 알려지지 않은 에러 |
| 401 | A100 | Invaild authentication information | 잘못된 인증 정보 |
| 403 | A110 | Blocked account | 차단된 계정 |
| 403 | A111 | Blocked account | 차단된 계정 |
| 403 | A113 | Invaild Expired Set Value | 유효하지 않은 Expired Set Value |
| 400 | A200 | Oversize attached file | 파일 크기 초과 |
| 400 | A201 | Overlength the image title | 이미지명 길이 초과 |
| 400 | A202 | Invaild file | 사용할 수 없는 파일 |
| 400 | A203 | Invalid Image resolution | 유효하지 않은 이미지해상도 |
| 400 | A204 | Missing file in the request | 업로드된 파일이 없거나 잘못된 요청 |
| 400 | A205 | Invalid MediaType | 파일의 Content-Type과 실제 MIME 타입 불일치 |
| 400 | A206 | Unsupported file format | 지원하지 않는 파일 형식 |
| 400 | A207 | Invalid or Empty Content-Disposition | 유효하지 않거나 비어있는 Content-Disposition |
| 400 | A208 | Invalid or Empty fileName | 유효하지 않거나 비어있는 fileName |
| 400 | A213 | Wrong request | 잘못된 요청 |
| 500 | A214 | Failed to process image file | 이미지 파일 처리 실패 |
| 500 | A215 | Upload to Mobile carrier failed | 이동통신사 이미지 업로드 실패 |
| 400 | A217 | Invaild fileKey | 유효하지 않은 fileKey |
| 400 | A219 | Invalid serviceType | 유효하지 않은 serviceType |
| 400 | A220 | Invalid msgType | 유효하지 않은 msgType |
| 400 | A801 | No permission to POLLING API | 리포트 POLLING API 사용권한 없음 |
| 403 | A802 | Invalid Report ID | 유효하지 않는 Report ID |
| 400 | A300 | Wrong request | 잘못된 메시지 발송 요청 |
| 400 | A302 | Invalid or empty 'from' | 유효하지 않거나 비어있는 필드 (필드명 : from) |
| 400 | A303 | Invalid or empty 'text' | 유효하지 않거나 비어있는 필드 (필드명 : text) |
| 400 | A304 | Invalid or empty 'ttl' | 유효하지 않거나 비어있는 필드 (필드명 : ttl) |
| 400 | A305 | Invalid or empty 'ref' | 유효하지 않거나 비어있는 필드 (필드명 : ref) |
| 400 | A306 | Invalid or empty 'to' | 유효하지 않거나 비어있는 필드 (필드명 : to) |
| 400 | A312 | Invalid or empty 'fallback.type' | 유효하지 않거나 비어있는 필드 (필드명 : fallback.type) |
| 400 | A313 | Invalid or empty 'clientSubId' | 유효하지 않거나 비어있는 필드 (필드명 : clientSubId) |
| 400 | A314 | Invalid or empty 'fallback.text' | 유효하지 않거나 비어있는 필드 (필드명 : fallback.text) |
| 400 | A317 | Number of 'fallback.filekey' exceeded | fallback 메시지 파일 키 수(3건) 초과 |
| 400 | A318 | Number of 'to' exceeded | 발송 가능한 수신번호 수(200건) 초과 |
| 400 | A319 | Number of 'filekey' exceeded | 첨부 가능한 파일 키 수(3건) 초과 |
| 400 | A320 | Number of 'client message count' exceeded | 메시지 제한건수 여분 초과 |
| 400 | A322 | Spam filtering(text) | 스팸 차단(메시지 내용) |
| 400 | A323 | Spam filtering(from) | 스팸 차단(발신 번호) |
| 400 | A324 | Spam filtering(to) | 스팸 차단(수신 번호) |
| 400 | A325 | No permission 'Message-Send' | 발송채널 권한 없음 |
| 400 | A326 | No Permission 'fallback' | MT fallback 기능 권한 없음 |
| 400 | A327 | Not Allowed 'from' | 미등록 발신번호 |
| 400 | A328 | Length of 'text' exceeded | 최대 길이 초과 (필드명 : text) |
| 400 | A329 | Length of 'fallback.text' exceeded | 최대 길이 초과 (필드명 : fallback.text) |
| 400 | A401 | Invalid or empty 'paymentCode' | 유효하지 않거나 비어있는 필드 (필드명 : paymentCode) |
| 400 | A402 | Invalid or empty 'clientSubId' | 유효하지 않거나 비어있는 필드 (필드명 : clientSubId) |
| 400 | A403 | Invalid or empty 'transferTime' | 유효하지 않거나 비어있는 필드 (필드명 : transferTime) |
| 400 | A404 | Invalid or empty 'formatId' | 유효하지 않거나 비어있는 필드 (필드명 : formatId) |
| 400 | A406 | Invalid or empty 'RCS button' | 유효하지 않거나 비어있는 필드 (필드명 : RCS button) |
| 400 | A407 | Invalid or empty 'copyallowed' | 유효하지 않거나 비어있는 필드 (필드명 : copyallowed) |
| 400 | A408 | Invalid or empty 'expiryOption' | 유효하지 않거나 비어있는 필드 (필드명 : expiryOption) |
| 400 | A409 | Invalid or empty 'groupId' | 유효하지 않거나 비어있는 필드 (필드명 : groupId) |
| 400 | A411 | Invalid or empty 'header' | 유효하지 않거나 비어있는 필드 (필드명 : header) |
| 400 | A412 | Invalid or empty 'footer' | 유효하지 않거나 비어있는 필드 (필드명 : footer) |
| 400 | A413 | Invalid or empty 'agencyId' | 유효하지 않거나 비어있는 필드 (필드명 : agencyId) |
| 400 | A415 | Invalid or empty 'rcs.content' | 유효하지 않거나 비어있는 필드 (필드명 : rcs.content) |
| 400 | A417 | Number of 'Carousel card' exceeded | RCS Carousel Card 수 초과 |
| 400 | A418 | Invalid or empty 'agencyKey' | 유효하지 않거나 비어있는 필드 (필드명 : agencyKey) |
| 400 | A419 | Invalid or empty 'brandId' | 유효하지 않거나 비어있는 필드 (필드명 : brandId) |
| 400 | A420 | Invalid or empty 'brandKey' | 유효하지 않거나 비어있는 필드 (필드명 : brandKey) |
| 400 | A424 | Number of 'SubContent' exceeded | RCS subContent 수 초과 |
| 400 | A425 | buttons field is optional when using body field | body 필드를 사용할 때, buttons 필드는 선택 사항입니다. |
| 400 | A426 | Invalid or empty 'button.type' | 유효하지 않거나 비어있는 필드 (button.type) |
| 400 | A427 | Invalid or empty 'button.name' | 유효하지 않거나 비어있는 필드 (button.name) |
| 400 | A428 | Invalid or empty button.type 'MAP_LOC' | 유효하지 않거나 비어있는 필드 ('MAP_LOC' 버튼) |
| 400 | A429 | Invalid or empty button.type 'MAP_QRY' | 유효하지 않거나 비어있는 필드 ('MAP_QRY' 버튼) |
| 400 | A430 | Invalid or empty button.type 'CALENDAR' | 유효하지 않거나 비어있는 필드 ('CALENDAR' 버튼) |
| 400 | A431 | Invalid or empty button.type 'COPY' | 유효하지 않거나 비어있는 필드 ('COPY' 버튼) |
| 400 | A432 | Invalid or empty button.type 'COM_T' | 유효하지 않거나 비어있는 필드 ('COM_T' 버튼) |
| 400 | A433 | Invalid or empty button.type 'COM_V' | 유효하지 않거나 비어있는 필드 ('COM_V' 버튼) |
| 400 | A434 | Invalid or empty button.type 'DIAL' | 유효하지 않거나 비어있는 필드 ('DIAL' 버튼) |
| 400 | A501 | Invalid or empty 'responseMethod' | 유효하지 않거나 비어있는 필드 (responseMethod) |
| 400 | A502 | Invalid or empty 'senderKey' | 유효하지 않거나 비어있는 필드 (senderKey) |
| 400 | A503 | Invalid or empty 'button' | 유효하지 않거나 비어있는 필드 (button) |
| 400 | A505 | Invalid or empty 'templateCode' | 유효하지 않거나 비어있는 필드 (templateCode) |
| 400 | A506 | Invalid or empty 'adFlag' | 유효하지 않거나 비어있는 필드 (adFlag) |
| 400 | A513 | Invalid or empty 'image' | 유효하지 않거나 비어있는 필드 (image) |
| 400 | A521 | Invalid or empty 'item.title/description' | 유효하지 않거나 비어있는 필드 (item`s tltle/description) |
| 400 | A523 | Invalid or empty 'msgType' | 유효하지 않거나 비어있는 필드 (msgType) |
| 400 | A524 | Invalid or empty 'button.type' | 유효하지 않거나 비어있는 필드 (button.type) |
| 400 | A525 | Invalid or empty 'button.name' | 유효하지 않거나 비어있는 필드 (button.name) |
| 400 | A526 | Invalid or empty 'timeout' | 유효하지 않거나 비어있는 필드 (timeout) |
| 400 | A559 | Invalid or empty 'price' | 유효하지 않거나 비어있는 필드 (price) |
| 400 | A560 | Invalid or empty 'itemHighlight.title/description' | 유효하지 않거나 비어있는 필드 (item.title/description) |
| 400 | A561 | Invalid or empty 'item.summary' | 유효하지 않거나 비어있는 필드 (item.summary) |
| 400 | A562 | Invalid or empty 'supplement.quickReply' | 유효하지 않거나 비어있는 필드 (supplement.quickReply) |
| 400 | A563 | Invalid or empty 'supplement.quickReply.type' | 유효하지 않거나 비어있는 필드 (supplement.quickReply.type) |
| 400 | A564 | Invalid or empty 'supplement.quickReply.name' | 유효하지 않거나 비어있는 필드 (supplement.quickReply.name) |
| 400 | A565 | Invalid or empty 'header' | 유효하지 않거나 비어있는 필드 (header) |
| 400 | A567 | Invalid or empty 'carousel' | 유효하지 않거나 비어있는 필드 (carousel) |
| 400 | A568 | Wrong FC/FA request | 잘못된 친구톡 케로셀 요청 |
| 400 | A569 | Invalid or empty 'adult' | 유효하지 않거나 비어있는 필드 (adult) |
| 400 | A570 | Invalid or empty 'targeting' | 유효하지 않거나 비어있는 필드 (targeting) |
| 400 | A571 | Invalid or empty 'sendType' | 유효하지 않거나 비어있는 필드 (sendType) |
| 400 | A572 | Invalid or empty 'message' | 유효하지 않거나 비어있는 필드 (message) |
| 400 | A573 | Invalid or empty 'attachment' | 유효하지 않거나 비어있는 필드 (attachment) |
리포트 코드
비동기 리포트로 전달되는 최종 처리 결과 코드입니다.
| Code | Result |
|---|---|
| 10000 | 성공 : 단말기 메시지 정상 도착 |
| 90000 | 실패 : 내부구간 실패 |
| 99999 | 실패 : 알수 없는 에러 |
| 22000 | 전송 시간 초과 |
| 22001 | 전송 실패 (무선망단) |
| 22002 | 전송 실패 (무선망 -> 단말기단) |
| 22003 | 단말기 전원 꺼짐 |
| 22004 | 단말기 메시지 버퍼 풀 |
| 22005 | 음영지역 |
| 22006 | 메시지 삭제됨 |
| 22007 | 일시적인 단말 문제 |
| 23000 | 전송할 수 없음 |
| 23001 | 가입자 없음 |
| 23002 | 성인 인증 실패 |
| 23003 | 수신번호 형식 오류 |
| 23004 | 단말기 서비스 일시 정지 |
| 23005 | 단말기 호 처리 상태 |
| 23006 | 착신 거절 |
| 23008 | 기타 단말기 문제 |
| 23009 | 메시지 형식 오류 |
| 23010 | MMS 미지원 단말 |
| 23011 | 서버 오류 (이통사) |
| 23012 | 스팸 |
| 23013 | 서비스 거부 |
| 23014 | 기타 |
| 23015 | 전송 경로 없음 |
| 23016 | 첨부파일 사이즈 제한 실패 |
| 23018 | 휴대폰 가입 이동통신사를 통해 발신번호 변작 방지 부가 서비스에 가입된 번호를 발신번호로 사용하는 경우 |
| 23019 | KISA에서 모든 고객사에 대하여 차단 처리 요청된 번호를 발신번호로 사용하는 경우 |
| 23022 | Charset conversion error |
| 23023 | 국내 수신 메시지에 적용되는 발신번호가 발신번호 사전등록 번호가 아닌 경우 |
| 23025 | 24시간 이내 중복 발송 |
| 23029 | 광고 전송 제한 시간 발송 |
| 23030 | MMS MT Failover 첨부파일 처리가 실패한 경우 |
| 23031 | FAILOVER_TIMEOUTSEND 발송 안함 설정에 의해Failover 처리하지 않은 경우 |
| 23032 | FAILOVER(MT) 기능 사용 불가 계정 |
| 23033 | MT Failover Parameter Error |
| 23034 | Invalid MMS MT File Key |
| 23035 | 해당 통신사 장애 설정 으로 전송 불가 |
| 23036 | KISA 최초 발신자 식별코드 오류로 발송 불가 |
| 23037 | RCS MT Failover 발송 시,KISA 최초 발신자 식별코드 오류로 발송 |
| 32000 | 전송 시간 초과 |
| 32001 | 전송 실패 (무선망단) |
| 32002 | 전송 실패 (무선망 -> 단말기단) |
| 32003 | 단말기 전원 꺼짐 |
| 32004 | 단말기 메시지 버퍼 풀 |
| 32005 | 음영지역 |
| 32006 | 메시지 삭제됨 |
| 32007 | 일시적인 단말 문제 |
| 33000 | 전송할 수 없음 |
| 33001 | 가입자 없음 |
| 33002 | 성인 인증 실패 |
| 33003 | 수신번호 형식 오류 |
| 33004 | 단말기 서비스 일시 정지 |
| 33005 | 단말기 호 처리 상태 |
| 33006 | 착신 거절 |
| 33008 | 기타 단말기 문제 |
| 33009 | 메시지 형식 오류 |
| 33010 | MMS 미지원 단말 |
| 33011 | 서버 오류 (이통사) |
| 33012 | 스팸 |
| 33013 | 서비스 거부 |
| 33014 | 기타 |
| 33015 | 전송 경로 없음 |
| 33016 | 첨부파일 사이즈 제한 실패 |
| 33018 | 휴대폰 가입 이동통신사를 통해 발신번호 변작 방지 부가 서비스에 가입된 번호를 발신번호로 사용하는 경우 |
| 33019 | KISA에서 모든 고객사에 대하여 차단 처리 요청된 번호를 발신번호로 사용하는 경우 |
| 33022 | Charset conversion error |
| 33023 | 국내 수신 메시지에 적용되는 발신번호가 발신번호 사전등록 번호가 아닌 경우 |
| 33025 | 24시간 이내 중복 발송 |
| 33029 | 광고 전송 제한 시간 발송 |
| 33030 | MMS MT Failover 첨부파일 처리가 실패한 경우 |
| 33031 | FAILOVER_TIMEOUTSEND 발송 안함 설정에 의해Failover 처리하지 않은 경우 |
| 33032 | FAILOVER(MT) 기능 사용 불가 계정 |
| 33033 | MT Failover Parameter Error |
| 33034 | Invalid MMS MT File Key |
| 33035 | 해당 통신사 장애 설정 으로 전송 불가 |
| 33036 | KISA 최초 발신자 식별코드 오류로 발송 불가 |
| 33100 | 통신사 재전송 시도 타임아웃 |
| 33101 | 아이폰이거나, 단말 자체가 RCS를 지원하지 않는 경우 |
| 33102 | 템플릿 발송시 header 필드 값을 1로 설정한 경우 |
| 33103 | 템플릿 발송시 button을 설정하여 발송한 경우 |
| 33104 | header 필드값이 0(광고문구표시안함),1(광고문구표시함) 이 아닐 경우 |
| 33105 | header 필드가 0(광고문구표시안함)인경우, footer에 값을 설정하는 경우 |
| 33106 | header 필드가 1(광고문구표시함)인경우, footer에 값을 설정하지 않는 경우 |
| 33107 | footer 에는 숫자/하이픈만 허용되며, 최대 20자까지만 허용 됨 |
| 33108 | 템플릿에서 description 타입의 경우, 등록 템플릿의 패턴과 일치 하지 않을 경우 |
| 33109 | title 최대글자수를 초과한 경우 |
| 33110 | description 최대글자수를 초과한 경우 |
| 33111 | 최대 버튼수를 초과한 경우 |
| 33112 | messagebaseID 별 정의된 카드개수에 대해 하기 내용이 한 개라도 없는 경우- MMS 캐로셀 : 카드별 내용, 제목, 이미지 중 한가지라도 입력 필요- MMS Standaard : 이미지 필수 |
| 33113 | 최대 미디어 용량을 초과한 경우 |
| 33114 | 이통사에서 중복 메시지 발생한 경우 |
| 33115 | 발신번호에 대해서 지정하지 않은 대행사로 발송한 경우 |
| 33116 | 브랜드에 대한 대행사가 지정되어 있지 않는 경우 |
| 33117 | 메시지 유효기간에 대한 통신사 설정값이 1(40초), 2(72시간) 이 아닌 경우 |
| 33118 | 최대 버튼 글자수 초과한 경우 |
| 33119 | 정의되지 않은 버튼을 사용한 경우 |
| 33120 | 유효하지 않은 파일 키 |
| 33121 | 메세지베이스 ID가 존재하지 않는 경우 |
| 33122 | 브랜드에 등록되지 않은 발신번호를 사용한 경우 |
| 33123 | 일 메시지 발송량을 초과한 경우 |
| 33124 | messagebase의 param 부정확하거나 누락된 필수 항목이 있을 경우 |
| 33200 | 브랜드 정보 오류 |
| 40001 | Authorization Header 가 누락됨 |
| 40002 | 접근 토큰이 누락됨 |
| 40003 | 접근 토큰이 유효하지 않음 |
| 40004 | 접근 토큰의 유효기간이 만료됨 |
| 40006 | 접근 토큰 내 client_id가 유효하지 않음 |
| 40007 | 접근 토큰 내 scope이 유효하지 않음 |
| 41002 | 송신 요청한 메시지의 상태가 전달됨(delivered)로 변경되기 전에 송신 요청을 취소하거나, expiry 시점에 송신 요청을 취소한 결과 |
| 41100 | RCS 서버 연결이 실패함 |
| 41101 | RCS 서버 연결이 지연됨 |
| 41102 | RCS 서버 요청 처리가 실패함 |
| 41103 | RCS 서버 요청 처리가 지연됨 |
| 41104 | RCS 메시지 처리 서비스(IM) 연결이 실패함 |
| 41105 | RCS 메시지 처리 서비스(IM) 연결이 지연됨 |
| 41106 | RCS 메시지 처리 서비스(IM) 요청 처리가 실패함 |
| 41107 | RCS 메시지 처리 서비스(IM) 요청 처리가 지연됨 |
| 41108 | RCS 메시지 처리 서비스(IM) 요청 처리 수행 중 실패함 |
| 41109 | RCS 메시지 처리 서비스(IM) 내부 오류 |
| 41111 | RCS 사용자 상태 서버 연결이 실패함 |
| 41112 | RCS 사용자 상태 서버 연결이 지연됨 |
| 41113 | RCS 사용자 상태 서버 요청이 실패함 |
| 41114 | RCS 사용자 상태 서버 요청 처리가 지연됨 |
| 41115 | 챗봇 정보 서버 요청이 실패함 |
| 41116 | 챗봇 정보 서버 요청 처리가 지연됨 |
| 41117 | 송신 메시지 취소 요청 처리가 실패함. 해당 메시지가 RCS 사용자에게 전달 되었는지 알 수 없음. |
| 41118 | 송신 요청한 파일 메시지의 파일을 삼성전자 MaaP 서비스 저장소에 저장 실패함. |
| 41200 | RCS 가입자가 아님, 요청한 MSISDN을 사용하는 RCS 사용자가 없음 |
| 41210 | RCS 사용자가 텍스트 메시지를 수신할 수 없음 |
| 41211 | RCS 사용자가 파일 메시지를 수신할 수 없음 |
| 41212 | RCS 사용자가 Richcard 메시지를 수신할 수 없음 * FNW. 11[1] 참고 |
| 41220 | RCS 사용자가 Extended bot message version 1.0 항목이 포함된 메시지를 수신할 수 없음 * FNW. 11[1] 참고 |
| 41221 | RCS 사용자가 Extended bot message version 1.1 항목이 포함된 메시지를 수신할 수 없음 * TTAK.KO-06.0410/R5 [3] 참고 |
| 41222 | RCS 사용자가 Extended bot message version 1.2 항목이 포함된 메시지를 수신할 수 없음 * TTAK.KO-06.0410/R5 [3] 참고 |
| 41230 | RCS 사용자가 Openrichcard version 1.0 항목이 포함된 메시지를 수신할 수 없음 * TTAK.KO-06.0410/R5 [3] 참고 |
| 41231 | RCS 사용자가 Openrichcard version 1.1 항목이 포함된 메시지를 수신할 수 없음 * TTAK.KO-06.0410/R5 [3] 참고 |
| 41232 | RCS 사용자가 Openrichcard version 1.2 항목이 포함된 메시지를 수신할 수 없음 * TTAK.KO-06.0410/R5 [3] 참고 |
| 41240 | RCS 사용자가 위치 정보 요청 메시지를 수신할 수 없음 * FNW. 11[1] 참고 |
| 42001 | BotServiceId를 사용하는 챗봇의 정보를 찾을 수 없음 |
| 42002 | 요청 parameter 에 Message ID 누락 |
| 42003 | 요청 parameter 에 Bot ID 누락 |
| 42004 | 요청 parameter RCS 사용자 MSISDN 누락 |
| 42005 | 요청 parameter의 RCS 사용자 MSISDN 포맷 오류 (+82) 포함 확인 필요함 |
| 42007 | 챗봇 상용화 전 테스트 시점에 수신 가능한 RCS 사용자 목록에 없는 RCS 사용자에게 메시지 송신 시도함 |
| 42008 | 요청 본문(Body)이 누락됨 |
| 42009 | 요청 메시지 필수 항목이 누락됨. 메시지가 isTyping, status, textMessage, audioMessage, fileMessage, geolocationPushMessage, openrichcardMessage, richcardMessage 중 하나가 아님. |
| 42010 | 요청 메시지 중복 항목이 포함됨. RCS Message 본문에 하나이상의 message 종류가 포함됨. |
| 42011 | 조회/변경 하려는 메시지ID를 가진 메시지가 없거나 상태 변경이 불가함 |
| 42012 | 타이핑 메시지 포맷이 잘못됨 |
| 42013 | trafficType에 예약되지 않은 타입이 포함됨. |
| 42014 | Suggested chiplist를 사용할 수 없는 메시지에 포함됨 |
| 42015 | Text 메시지가 비어 있음 (최소 1) |
| 42031 | richcardMessage내부에 richcard 혹은 richcardcarousel이 없음 |
| 42032 | richcardMessage내부에 richcard 와 richcardcarousel이 모두 존재함 |
| 42034 | Richcard layout이 없음 |
| 42035 | Richcard content가 없음 |
| 42036 | Richcard layout에 방향정보가 없거나 잘못됨. (“HORIZONTAL”과 “VERTICAL”만 허용함) |
| 42038 | Richcard 내 이미지 정렬 기준이 잘못됨. (layout 방향이 “HORIZONTAL”인 경우, “LEFT”, “RIGHT”만 허용함) |
| 42039 | Richcard 내 이미지 정렬 기준이 잘못됨. (layout 방향이 “VERTICAL”인 경우, 정력 기준 허용하지 않음. |
| 42040 | Richcard carousel의 카드넓이가 없거나 잘못됨. (“SMALL_WIDTH”, “MEDIUM_WIDTH”만 허용함) |
| 42041 | Richcard carousel의 카드넓이가 “SMALL_WIDTH”인 경우 모든 미디어의 높이가 “TALL_HEIGHT”가 아님. |
| 42042 | Richcard에 media, description, title이 모두 없음. Richcard Title이 없거나 200자 이상임. Richcard Description이 없거나 2000자 이상임. |
| 42043 | SuggestedChipList에 Suggestion 이 없음 |
| 42044 | SuggestedChipList에 Suggestion 이 11개를 초과함 |
| 42045 | Suggestion에 action과 reply가 없음 |
| 42046 | Suggestion이 action과 reply를 모두 가짐. |
| 42047 | Suggestion의 action내 action이 1개 이상임 |
| 42048 | Richcard에 Suggestion이 4개를 초과함 |
| 42049 | Suggestion의 action 혹은 reply의 postback data 길이가 2048을 초과함 |
| 42050 | Suggestion의 action 혹은 reply의 display text가 25자를 초과함 |
| 42051 | Map Action에 포함된 Location 오류 |
| 42052 | Map Action에 포함된 Location 내 query 혹은 latitude/longitude 만 허용함. 모두 포함됨 |
| 42053 | Map Action에 showLocation 혹은 requestLocationPush가 없음 |
| 42054 | Map Action에 showLocation 과 requestLocationPush가 모두 있음. |
| 42055 | Dialer Action에 phone number, enriched call, video call이 모두 없음 |
| 42056 | Dialer Action에 phone number, enriched call, video call 중 두 가지가 있음. |
| 42057 | Compose Action에 text나 recording message가 없음 |
| 42058 | Compose Action에 text와 recording message가 모두 존재함 |
| 42059 | Settings Action에 항목이 존재하지 않음 |
| 42060 | Settings Action에 항목이 중복됨. |
| 42061 | Clipboard Action에 복사할 text가 없음. |
| 42062 | Local browser Action에 url 이 없음 |
| 42063 | Share Action에 공유할 text 가 없음. |
| 42064 | Calendar Action에 createCalendarEvent가 없음 |
| 42065 | Calendar Action의 createCalendarEvent 내에 startTime, endTime, title 중 하나라도 없음 |
| 42066 | Calendar Action의 createCalendarEvent의 title이 최소 1자 최대 100자를 넘어섬 |
| 42067 | Calendar Action의 createCalendarEvent의 description이 최소 1자 최대 500자를 넘어섬 |
| 42068 | Compose Action의 composeTextMessage 내에 전화번호가 없거나 text가 최소 1자 최대 100자를 넘어섬 |
| 42069 | Compose Action의 composeRecodingMessage 내에 전화번호가 없거나 type이 “AUDIO” 혹은 “VIDEO” 가 아님 (대문자) |
| 42070 | Device Action에 requestDeviceSpecifics 가 비어있음 |
| 42071 | Dialer Action에 전화번호가 없거나 DialEnrichedCall 내의 subject 가 60자를 초과함 |
| 42072 | Map Action의 showLocation 내에 location 이 없음 |
| 42073 | Url Action의 openUrl이 없음 |
| 42100 | Richcard media thumbnail URL이 있으나 content type, file size 가 없음 |
| 42101 | File 메시지에 file URL이 없음 |
| 42102 | 오디오 메시지에 file URL이 없음 |
| 42103 | Geolocation push 메시지에 pos 정보가 없음 |
| 42104 | Richcard Media내 URL이 없음 |
| 42105 | Richcard Media내 content type이 없음 |
| 42106 | Richcard Media내 file size가 없음 |
| 42107 | Richcard Media내 높이가 없거나 잘못됨. “SHORT_HEIGHT”, “MEDIUM_HEIGHT”, “TALL_HEIGHT” 만 허용함. |
| 42108 | Suggestion의 action 혹은 reply의 postback data가 없음 |
| 42200 | URL 형태의 항목에 prefix가 없거나 (http:, https:, etc.) URI 포맷에 맞지않음 |
| 42201 | Geolocation push 메시지에 label 길이가 200을 초과함 |
| 42202 | Richcard content description 길이가 200자를 초과함 |
| 42205 | Richcard carousel content가 10개를 초과함 |
| 42206 | Richcard Media내 file size가 잘못됨 (0이하) |
| 42207 | Expiry 포맷이 RFC3339를 따르지 않음. |
| 42208 | Expiry 시각이 현재시각 이전임. |
| 42301 | Openrichcard에 layout이 없음 |
| 42302 | Openrichcard에 card가 없음 |
| 42303 | Openrichcard에 layout widget이 없음 (View, LinearLayout, TextView, ImageView 중 하나가 필수) |
| 42304 | Openrichcard View의 width/height가 누락됨 |
| 42305 | Openrichcard LinearLayout 필수 항목이 누락됨 |
| 42307 | Openrichcard TextView 필수 항목이 누락됨 |
| 42308 | Openrichcard TextView 텍스트 길이가 2000자를 초과함 |
| 42309 | Openrichcard ImageView 필수 항목이 누락됨 |
| 42310 | Openrichcard ImageView 미디어 파일 사이즈가 0 이하임 |
| 42311 | Openrichcard ImageView Scaletype에 허가되지 않은 문자열이 포함됨 |
| 42312 | Openrichcard content의 width/height가 누락됨 |
| 42313 | Openrichcard content의 width/height에 허가되지 않은 문자열이 포함됨 |
| 42314 | Openrichcard 공통 항목 오류 (Weight, Visibility, Background, Padding, PaddingTop, PaddingLeft, PaddingRight, PaddingBottom, Margin, MarginTop, MarginLeft, MarginRight, MarginBottom, CornerRadius) |
| 42315 | Openrichcard depth가 10을 초과함 |
| 42316 | Button widget의 필수 항목인 Click이 누락됨. |
| 42402 | 파일 메시지에 포함된 파일 URL로 다운로드 실패함 |
| 42514 | seqID와 동일한 messageID를 가진 이전 메시지가 존재함. 중복된 메시지 전송일 가능성이 있음. |
| 42601 | 삼성전자 MaaP 서비스가 제공하는 봇 메시지 처리량을 초과함 |
| 42602 | SPAM 메시지로 판정된 메시지(trafficType: advertisement-filtered, filtered)를 수신하여 CDR 생성 후 응답함. |
| 45000 | Internal Server Error |
| 45001 | 봇 정보 parsing 오류 |
| 45002 | RCS 사용자 혹은 봇 capability parsing 오류 |
| 45003 | 파일 메시지(xml) parsing 오류 |
| 45004 | 봇/사용자 메시지 remote cache 접근 실패 |
| 45005 | ChatID remote cache 접근 실패 |
| 45006 | 봇 정보 서버 접근을 위한 HTTP client 생성 실패 |
| 45007 | 챗봇 접근을 위한 HTTP client 생성 실패 |
| 50001 | Authorization 헤더 파라미터 누락 |
| 50002 | Authorization 헤더 값 누락 |
| 50003 | 토큰이 일치하지 않습니다. |
| 50004 | 토큰이 만료되었습니다. |
| 50005 | 인증 토큰 에러 |
| 50006 | 요청된 계정 정보를 찾을 수 없습니다(BP ID) |
| 50007 | 요청된 중계사 전송 계정을 찾을 수 없습니다(RCS ID) |
| 50008 | 잘못된 패스워드 |
| 50009 | 접근 허용된 IP가 아닙니다 |
| 50010 | 토큰 발급 요청 허용횟수를 초과하였습니다.(SKT) 미납으로 송신 불가 |
| 50011 | 중계사 상품코드 사용 권환 에러 |
| 50012 | 중계사 API 권환 에러 |
| 50100 | 메시지 전송을 할 수 없는 상태입니다. (서버의 요청 거부) |
| 50101 | 권한이 없는 API 호출 |
| 50201 | RCS 메시지 TPS가 초과되었습니다. |
| 50202 | RCS 메시지 Quota가 초과되었습니다. |
| 51003 | 중복 Key 오류 |
| 51004 | 요청 파라미터 형식 오류 |
| 51005 | 요청 Body JSON 파싱 에러 |
| 51006 | 데이터를 찾을 수 없음 |
| 51101 | AgencyKey를 찾을 수 없습니다. |
| 51102 | AgencyKey가 일치하지 않습니다. |
| 51103 | BrandKey를 찾을 수 없습니다. |
| 51104 | BrandKey가 일치하지 않습니다. |
| 51900 | 잘못된 요청입니다. |
| 51901 | 삼성 MaaP Gateway NB API 연동 에러 |
| 51902 | 삼성 MaaP Registry Chatbot API 연동 에러 |
| 51903 | Capri 연동 에러 |
| 51904 | Webhook 처리 불가 상태 오류가 발생했습니다. |
| 51905 | Webhook 메시지 전송 과금 이력 작성을 실패했습니다. |
| 51906 | 잘못된 Webhook Url 입니다. |
| 51907 | 만료된 메시지 입니다. |
| 51908 | 재시도 횟수 초과로 인해 메시지 전송을 실패했습니다. |
| 51909 | Webhook 발송 메시지가 존재하지 않습니다. |
| 51910 | Webhook 발송 중계사 정보가 존재하지 않습니다. |
| 51911 | 계약관계가 없습니다. |
| 51912 | 삼성 시뮬레이터 연동 오류 |
| 52001 | 전화번호 형식이 일치하지 않습니다 |
| 52002 | 요청을 처리할 수 없는 상태입니다. |
| 52003 | 이미 사용 중인 챗봇 ID입니다. |
| 52004 | 챗봇을 생성할 수 없습니다. |
| 52005 | 챗봇 정보를 변경할 수 없습니다. |
| 52006 | 챗봇이 있는 브랜드는 삭제 할수 없습니다. |
| 52007 | 챗봇 Type은 a2p, chatbot 로 설정해야 함 |
| 52008 | 요청 URL Parameter의 챗봇 Id와 Body Parameter 불일치 |
| 52009 | 챗봇 생성/업데이트 데이터에 오류가 있습니다. |
| 52010 | 챗봇 MO 메시지 웹훅 대행사 데이터 오류 |
| 52011 | 챗봇 MO 메시지 웹훅 대행사 데이터 정보가 누락되었음 |
| 52012 | Persistent menu JSON 데이터 오류 |
| 52016 | 실시간 메시지 인입 후 10초안에 삼성으로 전달되지 못함 |
| 52023 | 메시지 베이스의 상태가 'pause'인 메시지 베이스 메시지로 전문 구성하여 전송 시도 시 |
| 52098 | 해당 속성 접근 권한이 없음 |
| 52099 | Chatbot 접근 권한이 없음 |
| 52101 | 잘못된 Webhook 중계사 요청 파라미터 입니다. |
| 52102 | Webhook 중계 시스템 연결 오류 |
| 52103 | 중계사 Webhook 전송 요청을 실패 했습니다. |
| 52104 | 중계사 Webhook 처리 응답 수신 오류가 발생 했습니다. |
| 52105 | Webhook 메시지 미 수신 오류가 발생 했습니다. |
| 52106 | Webhook 메시지 처리 오류가 발생 했습니다. |
| 53001 | 요청을 처리할 수 없는 파일 유형입니다. |
| 53002 | 파일 속성 오류 |
| 53003 | fileID가 없거나 ID형식에 맞지 않음 |
| 53004 | File 저장 오류 |
| 53005 | Multipart 데이터 전송 오류 |
| 53006 | 업로드 파일 크기 초과 |
| 54001 | 자사 고객이 아닙니다. |
| 54002 | 자사 고객이지만, RCS메시지를 수신할 수 있는 가입자가 아닙니다. |
| 54003 | 단말기기로 RCS 메시지를 전송할 수 없습니다. |
| 54004 | MaaP 시스템 혹은 RCS 프로토콜 상의 이슈로 발송 실패되었음 (삼성 에러 40001 ~ 41100, 42601) |
| 54005 | 스팸 필터링에 의해 차단됨 |
| 54006 | RCS가입고객이지만 오픈리치카드 미지원 단말입니다.(SKT)자사 고객이지만, 요청한 스펙의 RCS 메시지를 수신할 수 있는 가입자가 아닙니다. |
| 55001 | 기업 정보 내용이 누락된 필수항목이 있습니다. |
| 55002 | 필수 파라미터 검증 오류 |
| 55101 | 대행사 정보 내용이 누락된 필수 항목이 있습니다. |
| 55102 | AgencyID가 존재하지 않습니다. |
| 55103 | BrandID에 대행 권한이 없는 AgencyID |
| 55104 | 계약 정보 내용이 부정확하거나 누락된 필수 항목이 있습니다. |
| 55201 | 브랜드 정보 내용이 누락된 필수항목이 있습니다. |
| 55202 | 브랜드 명이 누락되어 있습니다. |
| 55203 | 브랜드 프로필 이미지가 누락되어 있습니다. |
| 55204 | 브랜드 CS번호가 누락되어 있습니다. |
| 55205 | 브랜드 메뉴 최대 개수를 초과하였거나 부정확합니다. |
| 55206 | 브랜드 카테고리 설정이 잘못되어 있습니다. |
| 55207 | 브랜드 홈페이지 설정이 잘못되어 있습니다. |
| 55208 | 브랜드 이메일 설정이 잘못되어 있습니다. |
| 55209 | 브랜드 주소가 잘못되어 있습니다. |
| 55210 | 브랜드ID가 존재하지 않음 |
| 55301 | 챗봇 정보 내용이 부정확하거나 누락된 필수항목이 있습니다. |
| 55302 | BotID(발신번호)가 전화번호 형식에 맞지 않음 |
| 55303 | BrandID에 존재하지 않는 BotID |
| 55304 | BrandID에 존재하지 않는 BotID |
| 55501 | 메시지베이스 내용이 부정확하거나 누락된 필수항목이 있습니다. |
| 55502 | MessagebaseID가 존재하지 않음 |
| 55503 | BrandID에 존재하지 않는 MessagebaseID입니다. |
| 55504 | messagebase의 formatstring 누락된 필수 항목이 있습니다. |
| 55505 | messagebase의 policy Info가 부정확하거나 누락된 필수 항목이 있습니다. |
| 55506 | messagebase의 param 부정확하거나 누락된 필수 항목이 있습니다. |
| 55507 | messagebase의 attribute 부정확하거나 누락된 필수 항목이 있습니다. |
| 55508 | messagebase의 type 부정확하거나 누락된 필수 항목이 있습니다. |
| 55509 | messagebaseID의 product type과 일치하지 않음 |
| 55601 | MessagebaseForm 내용이 부정확하거나 누락된 필수항목이 있습니다. |
| 55602 | messagebaseformID가 존재하지 않습니다. |
| 55603 | messaegBase의 상품코드 에러 |
| 55604 | messaegBase의 child layout depth가 허용값보다 큽니다. |
| 55621 | AutoReplyMsg Body JSON 포맷 오류 |
| 55622 | AutoReplyMsg Buttons JSON 포맷 오류 |
| 55623 | AutoReplyMsg ChipList JSON 포맷 오류 |
| 55701 | "(광고)"를 사용할 수 없음 |
| 55702 | Action button이 허용되지 않는 messagebaseID에서 Action button을 사용하였음 |
| 55703 | 허용되지 않은 header 값 사용 |
| 55704 | header 값과 일치 하지 않은 footer 사용 (ex. header가 0 인데, footer 가 있음) |
| 55705 | footer값이 누락되어 있습니다 (ex. header가 1 인데, footer 가 없음) |
| 55706 | footer validation 오류 (ex. 숫자, 하이픈만 가능. 20자리) |
| 55707 | 등록한 패턴과 일치 하지 않음 |
| 55708 | title 최대글자수를 초과했습니다. |
| 55709 | description 최대글자수를 초과했습니다. |
| 55710 | 최대 버튼수를 초과했습니다. |
| 55711 | messagebaseID의 number of card 와 입력이 일치하지 않음 |
| 55712 | 최대 미디어 용량을 초과했습니다. |
| 55801 | 중계사 정보가 부정확하거나 누락된 필수 항목이 있습니다. |
| 55802 | 메시지 형식이 부정확하거나 누락된 필수항목이 있습니다. |
| 55803 | 메시지 기술방법이 잘못되었습니다. |
| 55804 | 메시지 내용이 누락되었거나 부정확합니다. |
| 55805 | 요청을 처리할 수 없는 메시지 유형입니다. |
| 55806 | 같은 메시지 ID로 두번 이상 메시지 발송이 요청됨 |
| 55807 | 챗봇 권한 오류 |
| 55808 | 발신 가능한 챗봇 상태가 아님 |
| 55809 | 대행사 권한 오류 |
| 55810 | 메시지 유효기간 입력값 오류 |
| 55811 | 메시지베이스 파라미터의 길이가 한계값 이상 |
| 55812 | 버튼 필드를 받을 수 없는 메시지베이스 입니다. |
| 55813 | 최대 버튼 글자수 초과 |
| 55814 | 버튼 형식 오류 |
| 55815 | 존재하지 않는 File이거나 usageType 오류 |
| 55816 | Empty suggestions array 허용 안함 |
| 55817 | 수신 번호 형식 오류 |
| 55818 | 메세지베이스 ID가 존재하지 않음 |
| 55819 | 챗봇ID가 존재하지 않음 |
| 55820 | Webhook Revoked 메시지 |
| 55821 | 전송 성공 불확실함 (revocation fail 등) |
| 55822 | 메시지 취소되어, 전송안됨 |
| 55880 | 버튼 개수 불일치 (Mismatched Suggestions Count) |
| 55881 | (양방향)유효한 replyId 아님 |
| 55882 | (양방향)replyId 값 누락 됨 |
| 55883 | (양방향)messagebase 상품 코드가 세션 메시지 가능하지 않음 |
| 55884 | (양방향)replyId 와 일치하는 수신번호가 아님 |
| 55885 | (양방향)replyId 와 일치하는 chatbotId 아님 |
| 55886 | (양방향)chipList 발송 가능하지 않음 |
| 55887 | (양방향)세션 메시지 발송 가능한 chatbot 아님 |
| 55900 | 잘못된 메시지 형식으로 인해 발송 실패되었고 재시도 가능하지 않음 (삼성 에러 42001 ~ 42514) |
| 55901 | 담당자 정보가 부정확하거나 누락된 필수항목이 있습니다. |
| 56002 | 메시지 회수 실패 (삼성 에러 41002) |
| 56007 | RCS 세션 연결 전 만료되어 발송 실패 (삼성 에러 41007) |
| 56101 | RCS 수신 가능여부를 확인할 수 없습니다. |
| 59001 | 시스템 에러 |
| 59002 | IO 에러 발생 /Backend(삼성 MaaP G/W) 서버 내부 에러 |
| 59003 | Backend(삼성 MaaP G/W) 서버 타임 아웃 발생 |
| 59202 | Backend 서버(삼성) 전송 에러 |
| 59203 | Backend 서버(삼성) 전송 타임 아웃 |
| 59901 | 시스템이 요청을 처리할 수 없는 상태 |
| 59999 | 기타 정의되지 않은 Error (Webhook Cancelled 메시지 등) |
| 60162 | 최초 발신자 식별 코드 에러 |
| 60400 | 권한 없음 |
| 60500 | 인증 실패 |
메시지 코드
이통사 코드, 서비스 메시지 타입 코드, 리포트 타입 코드를 확인합니다.
Carrier Code
| Code | Text | Description |
|---|---|---|
| 10000 | ETC | 기본값 |
| 10001 | SKT | SK텔레콤 |
| 10002 | KT | 케이티 |
| 10003 | LGU | LG유플러스 |
| 10006 | Internet number | 인터넷, 기타 번호(070) |
| 10010 | Safety number | 050번호 |
Report Type
| Code | Text | Description |
|---|---|---|
| 0 | 최종 결과 | (국내) 최종 단말기 전송 결과(국제) 국제 중계사 접수 결과*과금 기준 |
| 1 | 중간 결과 | 인포뱅크 접수 |
| 2 | 이통사 접수 결과 | 이통사 접수 |
| 3 | DLR 결과 | Delivery Reporting국제메시지 단말기 전송 결과 |