MTS API

RESTful API

알림톡 메시지 전송 API 테스트

알림톡 아이템리스트 메시지 전송 테스트

알림톡 메시지 전송 API 테스트(다중)

{"auth_code":"인증코드","data":[{"sender_key":"df8b597658c2702fbbaddb0d828cee19a51f18ca","nation_phone_number":"82","phone_number":"01012341234","template_code":"test201912091836","message":"[test]\n\n010-5025-8373 수신자 확인 테스트!","callback_number":"02-501-1980","attachment":{"button":[{"name":"홈연결","type":"WL","url_pc":"", "url_mobile":"http://m.mtsco.co.kr","target":"out"}]}},{"sender_key":"df8b597658c2702fbbaddb0d828cee19a51f18ca","nation_phone_number":"82","phone_number":"01012341234","template_code":"test201912091836","message":"[test]\n\n010-5025-8373 수신자 확인 테스트!","callback_number":"02-501-1980","attachment":{"button":[{"name":"홈연결","type":"WL","url_pc":"", "url_mobile":"http://m.mtsco.co.kr","target":"out"}]}},{"sender_key":"df8b597658c2702fbbaddb0d828cee19a51f18ca","nation_phone_number":"82","phone_number":"01012341234","template_code":"test201912091836","message":"[test]\n\n010-5025-8373 수신자 확인 테스트!","callback_number":"02-501-1980","attachment":{"button":[{"name":"홈연결","type":"WL","url_pc":"", "url_mobile":"http://m.mtsco.co.kr","target":"out"}]}}]}

친구톡 메시지 전송V2 API 일반 발송 테스트

친구톡 메시지 전송V2 API 이미지 발송 테스트

친구톡 메시지 전송V2 API 와이드 이미지 발송 테스트

친구톡 메시지 전송V2 API 와이드 아이템 리스트 발송 테스트

{"auth_code": "인증코드","sender_key": "df8b597658c2702fbbaddb0d828cee19a51f18ca","phone_number": "01012341234","messageType": "FL","ad_flag": "Y","subject":"testsub","message": "테스트메세지입니다.\n와이드아이템리스트발송","header":"리스트TITLE","callback_number": "02-501-1980","callback_url": "http://localhost/","attachment": {"item": {"list": [{"title": "아이템제목1","img_url": "https://mud-kage.kakao.com/dn/b2GqdN/btsnsfuD4PG/c1t9NukBLhFXcNeS7eS0Xk/img_l.jpg","url_mobile": "http://www.mtsco.co.kr"},{"title": "아이템제목2","img_url": "https://mud-kage.kakao.com/dn/pgVdD/btsnwQtjFHb/rlXvDFQ0MW1I2uVJ50bcPK/img_l.jpg","url_mobile": "http://www.mtsco.co.kr"},{"title": "아이템제목3","img_url": "https://mud-kage.kakao.com/dn/bjpPkw/btsnqwcjBPK/P9OLqBO7BG5Me544K2Tbu1/img_l.jpg","url_mobile": "http://www.mtsco.co.kr"},{"title": "아이템제목4","img_url": "https://mud-kage.kakao.com/dn/b2qTGu/btsnvXzHzN4/LFYlxKEo8JeQgBlZVQz4GK/img_l.jpg","url_mobile": "http://www.mtsco.co.kr"}]},"button": [{"name": "버튼제목1","type": "WL","url_mobile": "http://www.mtsco.co.kr"},{"name": "버튼제목2","type": "WL","url_mobile": "http://www.mtsco.co.kr"}]}}

※ 이미지는 친구톡 API에서 이미지를 업로드한 후 attachment에 이미지 경로를 추가하여야 합니다.

친구톡 메시지 전송V2 API 캐러셀 발송 테스트

{"auth_code": "인증코드","sender_key": "df8b597658c2702fbbaddb0d828cee19a51f18ca","phone_number": "01012341234","messageType": "FC","ad_flag": "Y","subject":"testsub","message": "테스트메세지입니다. 캐러셀발송","callback_number": "02-501-1980","callback_url": "http://localhost/","carousel": {"list": [{"header": "캐러셀아이템제목1","message": "캐러셀아이템메시지1 180자제한","attachment": {"image": {"img_url": "https://mud-kage.kakao.com/dn/0nkvt/btsmJPu4XKp/9qLdAvZs4q0nRbICqPEFgK/img_l.jpg","img_link": "http://www.mtsco.co.kr"},"button": [{"name": "버튼1","type": "WL","url_mobile": "http://www.mtsco.co.kr"},{"name": "버튼2","type": "WL","url_mobile": "http://www.mtsco.co.kr"}]}},{"header": "캐러셀아이템제목2","message": "캐러셀아이템메시지2 180자제한","attachment": {"image": {"img_url": "https://mud-kage.kakao.com/dn/FKBaV/btsmIs8ckWy/1KnG0f9iIV3m0ezdevgUw0/img_l.jpg","img_link": "http://www.mtsco.co.kr"},"button": [{"name": "버튼1","type": "WL","url_mobile": "http://www.mtsco.co.kr"},{"name": "버튼2","type": "WL","url_mobile": "http://www.mtsco.co.kr"}]}},{"header": "캐러셀아이템제목3","message": "캐러셀아이템메시지3 180자제한","attachment": {"image": {"img_url": "https://mud-kage.kakao.com/dn/jh19j/btsmHFtb9lu/yPWalVslTppRWAOpKQf791/img_l.jpg","img_link": "http://www.mtsco.co.kr"},"button": [{"name": "버튼1","type": "WL","url_mobile": "http://www.mtsco.co.kr"},{"name": "버튼2","type": "WL","url_mobile": "http://www.mtsco.co.kr"}]}},{"header": "캐러셀아이템제목4","message": "캐러셀아이템메시지4 180자제한","attachment": {"image": {"img_url": "https://mud-kage.kakao.com/dn/gjJWg/btsmFfvRcoE/66ucE5ngz9t4Rzxinqfzqk/img_l.jpg","img_link": "http://www.mtsco.co.kr"},"button": [{"name": "버튼1","type": "WL","url_mobile": "http://www.mtsco.co.kr"},{"name": "버튼2","type": "WL","url_mobile": "http://www.mtsco.co.kr"}]}},{"header": "캐러셀아이템제목5","message": "캐러셀아이템메시지5 180자제한","attachment": {"image": {"img_url": "https://mud-kage.kakao.com/dn/bAJMlS/btsmHjKHjIA/pboel0tGvrbwkDbjuE66Ik/img_l.jpg","img_link": "http://www.mtsco.co.kr"},"button": [{"name": "버튼1","type": "WL","url_mobile": "http://www.mtsco.co.kr"},{"name": "버튼2","type": "WL","url_mobile": "http://www.mtsco.co.kr"}]}},{"header": "캐러셀아이템제목6","message": "캐러셀아이템메시지6 180자제한","attachment": {"image": {"img_url": "https://mud-kage.kakao.com/dn/D1FGN/btsmGloZBq1/eRoCUxyQMt0KyP0kFUSZv0/img_l.jpg","img_link": "http://www.mtsco.co.kr"},"button": [{"name": "버튼1","type": "WL","url_mobile": "http://www.mtsco.co.kr"},{"name": "버튼2","type": "WL","url_mobile": "http://www.mtsco.co.kr"}]}}],"tail": {"url_pc": "http://www.mtsco.co.kr","url_mobile": "http://www.mtsco.co.kr"}}}

※ 이미지는 친구톡 API에서 이미지를 업로드한 후 carousel에 이미지 경로를 추가하여야 합니다.

친구톡 메시지 전송V2 API 테스트(다중)

{"auth_code":"인증코드","data":[{"sender_key":"df8b597658c2702fbbaddb0d828cee19a51f18ca","messageType":"FT","phone_number":"01012341234","template_code":"test20190430_1","message":"ffffff\ntest20190430_1\n내용이다","callback_number":"02-501-1980","callback_url":"http://localhost/","attachment":{"button":[{"name":"버튼명","type":"WL","url_pc":"http://naver.com", "url_mobile":"http://daum.net","target":"out"}]}},{"sender_key":"df8b597658c2702fbbaddb0d828cee19a51f18ca","messageType":"FT","phone_number":"01012341234","template_code":"test20190430_1","message":"ffffff\ntest20190430_1\n내용이다","callback_number":"02-501-1980","callback_url":"http://localhost/","attachment":{"button":[{"name":"버튼명","type":"WL","url_pc":"http://naver.com", "url_mobile":"http://daum.net","target":"out"}]}},{"sender_key":"df8b597658c2702fbbaddb0d828cee19a51f18ca","messageType":"FT","phone_number":"01012341234","template_code":"test20190430_1","message":"ffffff\ntest20190430_1\n내용이다","callback_number":"02-501-1980","callback_url":"http://localhost/","attachment":{"button":[{"name":"버튼명","type":"WL","url_pc":"http://naver.com", "url_mobile":"http://daum.net","target":"out"}]}}]}

SMS 메시지 전송 API 테스트

SMS 메시지 전송 API 테스트(다중)

MMS 메시지 전송 API 테스트

MMS 메시지 전송 API 테스트(다중)

전송결과코드

알림톡 / 친구톡 전송 결과 코드

1000 성공(과금)

1001 Request Body가 Json형식이 아님

1002 허브 파트너 키가 유효하지 않음

1003 발신 프로필 키가 유효하지 않음

1004 Request Body(Json)에서 name을 찾을 수 없음

1006 삭제된 발신프로필. (메시지 사업 담당자에게 문 의)

1007 차단 상태의 발신프로필. (메시지 사업 담당자에 게 문의)

1011 계약정보를 찾을 수 없음. (메시지 사업 담당자에 게 문의)

1012 잘못된 형식의 유저키 요청

1013 유효하지 않은 app연결

1014 유효하지 않은 사업자번호

1015 유효하지 않은 app user id 요청

1016 사업자등록번호 불일치

1020 올바른 유저 식별자 값이 하나도 없는 경우

1021 차단 상태의 카카오톡 채널 (카카오톡 채널 운영 툴에서 확인)

1022 닫힘 상태의 카카오톡 채널 (카카오톡 채널 운영 툴에서 확인)

1023 삭제된 카카오톡 채널 (카카오톡 채널 운영툴에서 확인)

1024 삭제대기 상태의 카카오톡 채널 (카카오톡 채널 운영 툴에서 확인)

1025 메시지차단 상태의 카카오톡 채널 (카카오톡 채널 운영 툴에서 확인)

1030 잘못된 파라메터 요청

2006 시리얼넘버 형식 불일치

3000 예기치 않은 오류 발생

3005 메시지를 발송했으나 수신확인 안됨 (성공불확실)

- 서버에는 암호화 되어 보관되며 3일 이내 수신 가능

3006 내부 시스템 오류로 메시지 전송 실패

3008 전화번호 오류

3010 Json 파싱 오류

3011 메시지가 존재하지 않음

3012 메시지 일련번호가 중복됨

- 메시지 일련번호는 CS처리를 위해 고유한 값이 부여되어야 함.

3013 메시지가 비어 있음

3014 메시지 길이 제한 오류

(템플릿별 제한 길이 또는 1000자 초과)

3015 템플릿을 찾을 수 없음

3016 메시지 내용이 템플릿과 일치하지 않음

3018 메시지를 전송할 수 없음

3019 톡 유저가 아님

3020 알림톡 수신 차단

3021 카카오톡 최소 버전 미지원

3022 메세지 발송 가능한 시간이 아님

(친구톡/마케팅 메시지는 08시부터 20시까지 발송 가능)

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 와이드 아이템 리스트 개수 최대 최소 개수 불일치

3051 캐러셀 아이템 리스트 개수 최소, 최대 개수 불일치

3052 캐러셀 아이템 메시지 길이 OVER

3056 와이드 아이템 리스트 타이틀 길이 제한 오류

3058 캐러셀 헤더 길이 제한 오류

4000 메시지 전송 결과를 찾을 수 없음

4001 알 수 없는 메시지 상태

8001 카카오 서버로 전송 중 오류 발생

8002 전송하고 응답이 없음(NO RESPONSE)

8003 메시지 키 생성 오류

8004 메시지 DB 입력 오류

8005 메시지 DB 메모리 큐 입력 오류

8006 메시지 타입 생성 오류

8007 이미지 파일 사이즈 규격 오류 (Over)

8008 이미지 파일 파일 생성 오류

8009 이미지 파일 정보 DB 입력 오류

8010 이미지 파일 전송 오류

9001 네트워크 오류로 인하여 전송 실패

9998 시스템에 문제가 발생하여 담당자가 확인하고 있는 경우

9999 시스템에 문제가 발생하여 담당자가 확인하고 있는 경우

200 요청 성공

400 Invalid Json ( 파싱에러 )

SMS 전송 결과 코드

00 성공

03 스팸

10 한도초과 발신 제한

11 수신번호 정합성 오류

55 레포트 수신시간 만료

31 Timeout, 음영지역, 파워 오프

33 기타 오류(이통사 문의 필요)

34 결번

35 단말기 파워 오프

36 음영지역

37 기타 요류(이통사 문의 필요)

40 발신번호 세칙 오류

41 발신번호 변작으로 등록된 발신번호 사용

50 사전 미등록 발신번호 사용

LMS(MMS) 전송 결과 코드

1000 성공

03 스팸

10 한도 초과 발신제한

11 수신번호 정합성 오류

26 평생번호 전송실패

40 발신번호세칙 오류

50 사전미등록 발신번호사용

101 메세지 내용 스팸

103 착신자 스팸

104 회신번호 스팸

112 레포트 수신 시간만료

114 문자피싱 미등록으로 인한 차단

116 발신번호 세칙 오류

117 수신번호 세칙 오류

202 착신가입자 없음

203 비가입자, 결번, 서비스정지

211 기간 만료

213 NPDB 오류

1013 결번

1026 음영지역

2003 메시지에 있는 주소를 MMS Relay/Server 가 찾을 수 없음

2007 메세지가 규격에 맞지 않거나 부적당함 / 메시지 ELEMENT 포맷 에러 / 번호 이동된 가입자

2101 올바른 컨텐츠가 아님

2103 미지원 단말

2107 착신번호 오류

4000 요구된 서비스가 실행될 수 없음

4005 일반적인 서비스 에러 / MMS G/W 내부 처리 중 처리 실패

4007 서비스를 요청한 클라이언트가 permission이 없는 경우

/ 미지원 단말 / 전송 실패 / 패스워드 인증 실패로 전송제한 - LGT

4008 이통사 일시적인 트래픽 초과로 인한 실패

4301 미 가입자 에러 오류

4305 비가용폰 오류

4307 일시정지 가입자 오류

5101 착신전환 조회 실패

5102 착신전환 횟수 초과 오류코드

6014 수신자가 착신거절 신청자

6072 MMS 비가용 단말

8011 SKT 단말기 응답없음

8012 SKT 이통사 오류 (이통사 문의 필요)

8200 MMSC 전송 시 알 수 없는 오류

8880 MMS 이미지 발송 시 : 발송할 수 없는 이미지 파일 또는 요청된 이미지 url 이 34.MMS 이미지 업로드 방식을 통해 서버에 업로드 되어있지 않음

9999 패킷오류

응답 코드

0000 성공

ER00 JSON 파싱 중 에러 발생

ER01 인증코드(auth_code) 내용이 없거나 유효하지 않음

ER02 발신프로필키 내용이 없음

ER03 수신자 번호와 앱 유저 아이디 내용이 없음

ER04 템플릿 코드 내용이 없음

ER05 메시지 내용이 없음

ER06 콜백 URL 이 유효하지 않음

ER07 발신 번호가 유효하지 않음

ER08 DATA 항목이 유효하지 않음

ER09 첨부한 이미지 파일을 찾을 수 없음

ER10 허용되지 않는 파일

ER13 price 값이 유효하지 않음

ER14 currency_type 값이 유효하지 않음

ER15 메시지 본문 크기가 너무 크거나 너무 김

ER16 전환전송시 사용할 메시지 크기가 너무 큼

ER17 사전 승인된 발신번호가 아님

ER31 잘못된 메시지 타입

ER32 header 내용이 너무 길거나 너무 큼

ER33 attachment 내용이 너무 길거나 너무 큼

ER34 carousel 내용이 너무 길거나 너무 큼

ER98 조건에 일치하는 메시지 없음

ER99 전송 메시지 등록에 실패, MTS 내부 처리 중 오류

RESTful API 테스트

RESTful API

알림톡 메시지 전송 API 테스트

알림톡 아이템리스트 메시지 전송 테스트

알림톡 메시지 전송 API 테스트(다중)

친구톡 메시지 전송V2 API 일반 발송 테스트

친구톡 메시지 전송V2 API 이미지 발송 테스트

친구톡 메시지 전송V2 API 와이드 이미지 발송 테스트

친구톡 메시지 전송V2 API 와이드 아이템 리스트 발송 테스트

친구톡 메시지 전송V2 API 캐러셀 발송 테스트

친구톡 메시지 전송V2 API 테스트(다중)

SMS 메시지 전송 API 테스트

SMS 메시지 전송 API 테스트(다중)

MMS 메시지 전송 API 테스트

MMS 메시지 전송 API 테스트(다중)

RESTful 응답 API

알림톡 메시지 전송 API 테스트

친구톡 메시지 전송V2 API 테스트

SMS 메시지 전송 API 테스트

MMS 메시지 전송 API 테스트

이미지 API

친구톡 일반 이미지 전송 API 테스트

친구톡 와이드 이미지 전송 API 테스트

친구톡 와이드 아이템 리스트 전송 API 테스트

친구톡 캐러셀 이미지 전송 API 테스트

MMS 이미지 업로드 API 테스트

전송결과코드

알림톡 / 친구톡 전송 결과 코드

SMS 전송 결과 코드

LMS(MMS) 전송 결과 코드

응답 코드

RESTful API 테스트

RESTful API 가이드 다운로드

알림톡 메시지 전송 API 테스트

알림톡 아이템리스트 메시지 전송 테스트

알림톡 메시지 전송 API 테스트(다중)

친구톡 메시지 전송V2 API 일반 발송 테스트

친구톡 메시지 전송V2 API 이미지 발송 테스트

친구톡 메시지 전송V2 API 와이드 이미지 발송 테스트

친구톡 메시지 전송V2 API 와이드 아이템 리스트 발송 테스트

친구톡 메시지 전송V2 API 캐러셀 발송 테스트

친구톡 메시지 전송V2 API 테스트(다중)

SMS 메시지 전송 API 테스트

SMS 메시지 전송 API 테스트(다중)

MMS 메시지 전송 API 테스트

MMS 메시지 전송 API 테스트(다중)

RESTful 응답 API

알림톡 메시지 전송 API 테스트

친구톡 메시지 전송V2 API 테스트

SMS 메시지 전송 API 테스트

MMS 메시지 전송 API 테스트

이미지 API

친구톡 일반 이미지 전송 API 테스트

친구톡 와이드 이미지 전송 API 테스트

친구톡 와이드 아이템 리스트 전송 API 테스트

친구톡 캐러셀 이미지 전송 API 테스트

MMS 이미지 업로드 API 테스트

전송결과코드

알림톡 / 친구톡 전송 결과 코드

SMS 전송 결과 코드

LMS(MMS) 전송 결과 코드

응답 코드

RESTful API