발송결과 상세 조회
API 목록
GET
/v1/openapi/message/receiver/{msgGrpNo}
발송내역 상세 조회 API
1. 발송내역 상세 조회
발송 내역 상세 조회는 항상 messageId 기준으로 오름차순 정렬됩니다
GEThttps://api.megabird.co.kr:8080/v1/openapi/message/receiver/{msgGrpNo}
1.1 Path Parameter
msgGrpNo
String
Y
메시지그룹번호
101291
1.2 Query String Parameters
tgusNm
String
N
수신자명
홍길동
mblnum
String
N
수신자번호
01012341234
pageSize
Integer
N
한번에 조회할 목록 수 ( Default : 100 )
1
lastSeenId
String
N
마지막으로 확인된 messageId
20
1.3 Response Body Parameters
code
String
성공코드
1.3.1 result (응답데이터)
totalCount
Integer
전체 조회 수
hasNext
Boolean
다음 결과 데이터 존재 유무
lastSeenId
String
마지막으로 확인된 messageI
1.3.2 result (발송결과 상세조회 리스트)
msgGrpNo
Long
메시지그룹번호
messageId
String
메시지 아이디
addrGrpNm
String
그룹명
mblnum
String
휴대폰번호
tgusNm
String
수신자명
svcKndCd
String
서비스종류코드 [AUTHSMS], [SMS], [LMS], [MMS], [TKA]알림톡(텍스트), [TKI]알림톡(이미지), [TKT]친구톡(텍스트), [TKF]친구톡(이미지), [TKW]친구톡(와이드)
svcKndCdNm
String
서비스종류코드명
sndStsCd
String
발송상태코드 (MTC - 발송완료 , MTF - 발송실패)
sndStsCdNm
String
발송상태코드명
sndStsCzCmt
String
발송결과 설명
regDtt
String
등록일시
sndCplDtt
String
발송완료일시
1.4 Response Example
{
"code": "0000",
"result": {
"totalCount": 2,
"hasNext": true,
"lastSeenId": "20341531f9514b27b14371100bda5ff3",
"result": [
{
"messageId":"00000131f9514b27b14371100bda5ff3",
"addrGrpNm": "주소록1",
"mblnum": "01012341234",
"tgusNm": "홍길동",
"svcKndCd": "TKT",
"svcKndCdNm": "친구톡(텍스트)",
"sndStsCd": "MTF",
"sndStsCdNm": "발송실패",
"sndRstCd": "9999",
"sndStsCzCmt": "메시지 전송 실패",
"regDtt": "2022-10-12T16:53:04",
"sndCplDtt": "2022-10-12T16:53:18"
},
{
"messageId":"20341531f9514b27b14371100bda5ff3",
"addrGrpNm": "주소록1",
"mblnum": "01012345678",
"tgusNm": "김나라",
"svcKndCd": "SMS",
"svcKndCdNm": "SMS",
"sndStsCd": "MTC",
"sndStsCdNm": "발송완료",
"sndRstCd": "1000",
"sndStsCzCmt": "전송 완료",
"regDtt": "2022-10-12T16:53:04",
"sndCplDtt": "2022-10-12T16:53:18"
}
]
}
}1.5 상세 발송 결과 코드 (sndRstCd/sndStsCzCmt)
공통
sndRstCd sndStsCzCmt
5 내용 형식 오류
33 전화번호 형식 오류
37 일반문자 수신거부 차단
300 Invalid Receiver Phone Number
301 Spam checked
302 Receiver Ban Phone Number
303 Callback Ban Phone Number
304 Spam checked
400 Format Error
500 Failure
912 080 수신거부 차단
7100 내부 타임아웃(72시간)
7301 스미싱 차단
7401 사전 미등록 발신번호 사용
7402 전화번호 세칙 미준수 발신번호 사용
7777 ACK 미수신
8000 컨텐츠 에러
8100 JSON 포맷 에러
9000 알 수 없는 에러
9999 기타 에러
6001 잘못된 수신번호
6002 비 가입자, 결번, 서비스 정지
6003 번호 이동
6100 타임 아웃
6101 음영 지역
6102 전원 꺼짐
6103 메시지 저장 초과
6104 착신 거절
6105 단말기 BUSY
6106 단말기 일시정지
6107 단말기 착신거부
6108 서비스 불가 단말기
6109 핸드폰 호 불가 상태
6200 SMC 운영자가 삭제한 메시지
6201 통신사 형식 오류
6202 무선망단 실패
6300 스팸
6401 사전 미등록 발신번호 사용
6402 전화번호 세칙 미준수 발신번호 사용
6403 발신번호 변작으로 등록된 발신번호 사용
6404 번호도용문자차단서비스에 가입된 발신번호 사용
6410 미입력 식별코드 차단
6500 내부 형식 오류
6501 메시지의 길이 초과
6502 첨부파일 사이즈 초과
6600 기타 에러SMS
sndRstCd sndStsCzCmt
1000 성공
1001 스팸(과금성공)
2001 잘못된 수신번호
2002 비 가입자, 결번, 서비스 정지
2003 번호 이동
2100 타임 아웃
2101 음영 지역
2102 전원 꺼짐
2103 메시지 저장 초과
2104 착신 거절
2105 단말기 BUSY
2106 단말기 일시정지
2107 단말기 착신거부
2108 서비스 불가 단말기
2109 핸드폰 호 불가 상태
2200 SMC 운영자가 삭제한 메시지
2201 통신사 형식 오류
2202 무선망단 실패
2300 스팸
2401 사전 미등록 발신번호 사용
2402 전화번호 세칙 미준수 발신번호 사용
2403 발신번호 변작으로 등록된 발신번호 사용
2404 번호도용문자차단서비스에 가입된 발신번호 사용
2500 내부 형식 오류
2501 메시지의 길이 초과
2600 기타 에러LMS/MMS
sndRstCd sndStsCzCmt
1000 성공
1001 스팸(과금성공)
3001 잘못된 수신번호
3002 비 가입자, 결번, 서비스 정지
3003 번호 이동
3100 타임 아웃
3101 음영 지역
3102 전원 꺼짐
3103 메시지 저장 초과
3104 착신 거절
3105 단말기 BUSY
3106 단말기 일시정지
3107 단말기 착신거부
3108 서비스 불가 단말기
3109 핸드폰 호 불가 상태
3200 SMC 운영자가 삭제한 메시지
3201 통신사 형식 오류
3202 무선망단 실패
3300 스팸
3401 사전 미등록 발신번호 사용
3402 전화번호 세칙 미준수 발신번호 사용
3403 발신번호 변작으로 등록된 발신번호 사용
3404 번호도용문자차단서비스에 가입된 발신번호 사용
3500 내부 형식 오류
3501 메시지의 길이 초과
3502 첨부파일 사이즈 초과
3600 기타 에러KKO
sndRstCd sndStsCzCmt
1000 성공
4001 잘못된 수신번호
4002 친구톡 전송 시 친구 대상 아님
4100 타임아웃
4200 Sender key (발신프로필키) 유효하지 않음
4201 Sender key (발신프로필키) 존재하지 않음
4202 삭제된 Sender key (발신프로필키)
4203 차단 상태 Sender key (발신프로필키)
4300 차단 상태 옐로우 아이디
4301 닫힌 상태 옐로우 아이디
4302 삭제된 옐로우 아이디
4400 템플릿 불일치
4401 템플릿 없음
4500 메시지가 존재하지 않음
4501 메시지 길이 초과
4502 메시지를 전송할 수 없음
4503 메시지 발송 불가 시간
4504 메시지 그룹 정보를 찾을 수 없음
4505 카카오 형식 오류
4506 카카오 시스템 오류
4600 기타 에러Last updated