4603 lines
299 KiB
HTML
4603 lines
299 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="ko">
|
|
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
<title>문자온 API 소개</title>
|
|
|
|
<link href="https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@100;300;400;500;700;900&display=swap" rel="stylesheet">
|
|
<link rel="stylesheet" href="/publish/css/reset.css">
|
|
<link rel="stylesheet" href="/publish/css/jquery.mCustomScrollbar.css">
|
|
<link rel="stylesheet" href="/publish/css/common.css">
|
|
<link rel="stylesheet" href="/publish/css/button.css">
|
|
<link rel="stylesheet" href="/publish/css/content.css">
|
|
<link rel="stylesheet" href="/publish/css/font.css">
|
|
|
|
<script src="/publish/js/jquery-3.5.0.js"></script>
|
|
<script src="/publish/js/common.js"></script>
|
|
<script src="/publish/js/content.js"></script>
|
|
<script src="/publish/js/allimtalk.js"></script>
|
|
<script src="/publish/js/kakao_allimtalk.js"></script>
|
|
|
|
</head>
|
|
|
|
<body>
|
|
<div class="skip_menu">
|
|
<a href="#cont" title="본문 바로가기" class="contGo">본문 바로가기</a>
|
|
</div>
|
|
<!--// skip 메뉴 -->
|
|
<!-- quick 메뉴 -->
|
|
<div class="quickMenu">
|
|
<div>
|
|
<p class="quick_title">QUICK<br>MENU</p>
|
|
<p class="quick_title2">QUICK</p>
|
|
<ul class="quickMenuIn">
|
|
<li>
|
|
<a href="/publish/index.html"><i class="quick1"></i><span>이용안내</span></a>
|
|
<div class="hover_cont">이용안내</div>
|
|
</li>
|
|
<li>
|
|
<a href="#"><i class="quick2"></i><span>채 팅상담</span></a>
|
|
<div class="hover_cont">채팅상담</div>
|
|
</li>
|
|
<li>
|
|
<a href="#"><i class="quick3"></i><span>원격지원</span></a>
|
|
<div class="hover_cont">원격지원</div>
|
|
</li>
|
|
<li>
|
|
<a href="#"><i class="quick4"></i><span>맞춤제작</span></a>
|
|
<div class="hover_cont">맞춤제작</div>
|
|
</li>
|
|
<li>
|
|
<a href="#"><i class="quick5"></i><span>주소록 등록</span></a>
|
|
<div class="hover_cont">주소록 등록</div>
|
|
</li>
|
|
<li>
|
|
<a href="#"><i class="quick6"></i><span>엑셀 전송</span></a>
|
|
<div class="hover_cont">엑셀 대량전송</div>
|
|
</li>
|
|
<li>
|
|
<a href="#"><i class="quick7"></i><span>견적서</span></a>
|
|
<div class="hover_cont">견적서</div>
|
|
</li>
|
|
<li>
|
|
<a href="#"><i class="quick8"></i><span>결제</span></a>
|
|
<div class="hover_cont">결제</div>
|
|
</li>
|
|
<li>
|
|
<a href="#"><i class="quick9"></i><span>영수증/계산서</span></a>
|
|
<div class="hover_cont">영수증/계산서</div>
|
|
</li>
|
|
</ul>
|
|
<button type="button" class="goTop" title="맨 위로 이동">TOP<i></i></button>
|
|
</div>
|
|
</div>
|
|
<!--// quick 메뉴 -->
|
|
<!-- header 영역 -->
|
|
<header id="header" class="header sub ">
|
|
<!-- header top 영역 -->
|
|
<div class="header_top">
|
|
<div class="inner">
|
|
<ul class="menu_left">
|
|
<li><a href="#"><i class="hdTop_fav"></i>즐겨찾기추가</a></li>
|
|
<li><a href="#"><i class="hdTop_mypage"></i>마이페이지</a></li>
|
|
<li><a href="#"><i class="hdTop_center"></i>고객센터</a></li>
|
|
</ul>
|
|
<ul class="menu_right">
|
|
<li><a href="#">충전하기</a></li>
|
|
<li class="SortLine"><a href="#">요금안내</a></li>
|
|
<li class="SortLine"><a href="#">이용안내</a></li>
|
|
<li class="SortLine"><a href="#">1:1고객상담</a></li>
|
|
</ul>
|
|
</div>
|
|
</div><!-- header top 영역 -->
|
|
<!-- header body 영역 -->
|
|
<div class="header_body">
|
|
<div class="inner table">
|
|
<h1 class="logo"><a href="/publish/index.html" alt="문자온 메인 바로가기"><img src="/publish/images/CI.png" alt="문자온 CI"></a></h1>
|
|
<ul class="gnbWrap table_cell">
|
|
<li><a href="#">문자발송</a></li>
|
|
<li><a href="#">선거문자</a></li>
|
|
<li><a href="#">맞춤제작</a></li>
|
|
<li><a href="#">비즈톡</a></li>
|
|
<li><a href="#">주소록 관리</a></li>
|
|
<li><a href="#">발송결과</a></li>
|
|
<li><a href="#">예약관리</a></li>
|
|
<li><a href="#">결제내역</a></li>
|
|
</ul>
|
|
<div class="s_menu">
|
|
<i class="allSearch_info"><span>문자검색</span></i>
|
|
<button type="button" title="전체검색" class="allSearch" onclick="searchToggle();"><img src="/publish/images/search.png" alt="검색영역 열기" class="allMenu"></button>
|
|
<button type="button" title="전체메뉴"><img src="/publish/images/all_menu.png" alt="전체메뉴 열기"></button>
|
|
</div>
|
|
</div>
|
|
<!-- search popup 영역 -->
|
|
<div class="pop_search">
|
|
<div class="inner">
|
|
<div class="area_search">
|
|
<select name="" id="">
|
|
<option value="">그림문자</option>
|
|
<option value="">단문문자</option>
|
|
<option value="">장문문자</option>
|
|
<option value="">GIF</option>
|
|
</select>
|
|
<input type="text" placeholder="문자샘플 검색하기">
|
|
<button><img src="/publish/images/search02.png" alt=""></button>
|
|
</div>
|
|
<div class="area_popular">
|
|
<p><i></i>인기검색어</p>
|
|
<ul class="popular_tag">
|
|
<li><a href="#">#정월대보름</a></li>
|
|
<li class="on"><a href="#">#추석</a></li>
|
|
<li><a href="#">#가을인사</a></li>
|
|
<li><a href="#">#좋은하루</a></li>
|
|
</ul>
|
|
</div>
|
|
<button class="btn_close" onclick="searchToggle();"><img src="/publish/images/btn_searchclose.png" alt=""></button>
|
|
</div>
|
|
</div>
|
|
<!--// search popup 영역 -->
|
|
</div>
|
|
<!--// header body 영역 -->
|
|
<div id="login" class="login">
|
|
<div class="inner table">
|
|
<div class="login_left table_cell">
|
|
<div class="login_put">
|
|
<label for="id_text" class="label"></label>
|
|
<input type="text" placeholder="아이디를 입력해주세요" id="id_text" class="id_text" maxlength="30" size="18">
|
|
<label for="password_text" class="label"></label>
|
|
<input type="password" placeholder="비밀번호를 입력해주세요" id="password_text" class="password_text" maxlength="30" size="18">
|
|
<label for="login_button" class="label"></label>
|
|
<button type="submit" class="btnType btnType1" class="login_button">로그인</button>
|
|
</div>
|
|
<div class="login_save">
|
|
<input type="checkbox" id="save_id">
|
|
<label for="save_id">아이디 저장</label>
|
|
</div>
|
|
<div class="login_find">
|
|
<a href="#">아이디찾기 /</a>
|
|
<a href="#">비밀번호 찾기</a>
|
|
</div>
|
|
<div>
|
|
<button type="button" class="btnType btnType2">회원가입</button>
|
|
<button type="button" class="btnType btnType3">둘러보기</button>
|
|
</div>
|
|
</div>
|
|
<div class="login_right">
|
|
<span><i></i>이달의 이벤트</span>
|
|
<button type="button" class="btnType btnType4">바로가기</button>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!--// login 영역 -->
|
|
</header>
|
|
<!--// header 영역 -->
|
|
<!-- login 영역 -->
|
|
<!-- content 영역 -->
|
|
<div id="container" class="cont sub">
|
|
<div class="inner">
|
|
<!-- send top -->
|
|
<div class="send_top">
|
|
<!-- tab button -->
|
|
<ul class="tabType4">
|
|
<li class="tab "><button type="button" onclick="location.href='/publish/api_intro.html'">연동 안내</button></li>
|
|
<li class="tab active"><button type="button" onclick="location.href='/publish/api_guide.html'">개발 가이드</button></li>
|
|
<li class="tab"><button type="button" onclick="location.href='/publish/api_download.html'">예제 다운로드</button></li>
|
|
<li class="tab"><button type="button" onclick="location.href='/publish/api_admin1.html'">신청/관리</button></li>
|
|
</ul>
|
|
<!--// tab button -->
|
|
|
|
<div class="api_guide_cont current">
|
|
<div class="heading">
|
|
<h2>REST API 개발 가이드</h2>
|
|
</div>
|
|
|
|
<!--사용안내 내용-->
|
|
|
|
<div class="pay_tab_wrap">
|
|
<ul class="tabType1">
|
|
<li class="tab active"><button type="button" onclick="TabType5(this,'1');TabType2(this,'1');$('.list_tab li:nth-child(1)').addClass('active').siblings().removeClass('active');">문자</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType5(this,'2');TabType2(this,'6');$('.list_tab li:nth-child(1)').addClass('active').siblings().removeClass('active');">알림톡</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType5(this,'3');TabType2(this,'13');$('.list_tab li:nth-child(1)').addClass('active').siblings().removeClass('active');">친구톡</button></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<!-- REST API 개발 가이드 > 문자 -->
|
|
<div class="api_guide current" id="tab5_1">
|
|
<div class="list_tab_wrap2 type3">
|
|
<!--콘텐츠 tab button-->
|
|
<ul class="list_tab">
|
|
<li class="tab active"><button type="button" onclick="TabType2(this,'1');">문자발송</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'2');">문자발송(대량)</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'3');">전송결과조회</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'4');">상세결과조회</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'5');">발송가능건수</button></li>
|
|
</ul>
|
|
<!--//콘텐츠 tab button-->
|
|
</div>
|
|
|
|
<div class="api_guide_con current" id="tab2_1">
|
|
|
|
<ul class="info">
|
|
<li>- API를 통해서 동일한 내용의 문자를 대량으로 전송할 수 있습니다.</li>
|
|
<li>- 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용)</li>
|
|
<li>- 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>문자발송 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callFrom</span></td>
|
|
<td>발신자 번호(아이디에 등록되어 있는 번호)</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callToList</span></td>
|
|
<td>수신자 번호(콤마(,) 기준으로 입력)</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">smsTxt</span></td>
|
|
<td>메시지 내용</td>
|
|
<td>String(1~2,000Byte)</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">nameStr</span></td>
|
|
<td>메시지 내용에 [*이름*]이 있으면 치환용 이름 입력( | 로 구분 )</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
<p>※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"홍길동"</p>
|
|
<p>,<span>"accessKey"</span>:"XXXXXXXXXXXXXX414050694b953"</p>
|
|
<p>,<span>"callFrom"</span>:"01012341234"</p>
|
|
<p>,<span>"callToList"</span>:"01011111111,01022222222,01033333333"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 테스트~![*이름*]"</p>
|
|
<p>,<span>"nameStr"</span>:"홍길동1|홍길동2|홍길동3"</p>
|
|
<p>,<span>"test_yn"</span>:""</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>문자발송 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgType</span></td>
|
|
<td>메시지 타입(4 : 단문, 5 : 장문)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].blockCnt</span></td>
|
|
<td>수신거부 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].failCnt</span></td>
|
|
<td>전송 실패 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].successCnt</span></td>
|
|
<td>성공 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"msgGroupId"</span>:"MSGGID_0000000000000"</p>
|
|
<p>,<span>"msgType"</span>:"SMS"</p>
|
|
<p>,<span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"blockCnt"</span>:"0"</p>
|
|
<p>,<span>"failCnt"</span>:"0"</p>
|
|
<p>,<span>"successCnt"</span>:"3"</p>
|
|
<p>,<span>"test_yn"</span>:null</p>
|
|
</div>
|
|
<p>｝</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"1040"</p>
|
|
<p>,<span>"data"</span>:"치환 데이터 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_2">
|
|
|
|
<ul class="info">
|
|
<li>- API를 통해서 다른 내용의 문자를 대량으로 전송할 수 있습니다.</li>
|
|
<li>- 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용)</li>
|
|
<li>- 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>문자발송(대량) API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callFrom</span></td>
|
|
<td>발신자 번호(아이디에 등록되어 있는 번호)</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callTo_1</span></td>
|
|
<td>수신자 번호 1</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">smsTxt_1</span></td>
|
|
<td>메시지 내용 1 </td>
|
|
<td>String(1~2,000Byte)</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">...</span></td>
|
|
<td>...</td>
|
|
<td>...</td>
|
|
<td><span class="select_o">...</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callTo_100</span></td>
|
|
<td>수신자 번호 100</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">smsTxt_100</span></td>
|
|
<td>메시지 내용 100</td>
|
|
<td>String(1~2,000Byte)</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"홍길동"</p>
|
|
<p>,<span>"accessKey"</span>:"XXXXXXXXXXXXXX414050694b953"</p>
|
|
<p>,<span>"callFrom"</span>:"01012341234"</p>
|
|
<p>,<span>"test_yn"</span>:""</p>
|
|
<p>,<span>"callTo_1"</span>:"01011111111"</p>
|
|
<p>,<span>"smsTxt_1"</span>:"문자 테스트 1"</p>
|
|
<p>,<span>"callTo_2"</span>:"01022222222"</p>
|
|
<p>,<span>"smsTxt_2"</span>:"문자 테스트 2"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>문자발송(대량) API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupIdList</span></td>
|
|
<td>메시지 그룹 ID 리스트</td>
|
|
<td>List String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgType</span></td>
|
|
<td>메시지 타입(4 : 단문, 5 : 장문)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].blockCnt</span></td>
|
|
<td>수신거부 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].failCnt</span></td>
|
|
<td>전송 실패 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].successCnt</span></td>
|
|
<td>성공 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>:［</p>
|
|
<div class="indent_t1">
|
|
<p><span>"msgGroupIdList"</span>:［</p>
|
|
<p>｛</p>
|
|
<p class="m_code">"MSGGID_0000000013451"</p>
|
|
<p class="l_code_t1">｝</p>
|
|
<p>,｛</p>
|
|
<p class="m_code">"MSGGID_0000000013452"</p>
|
|
<p class="l_code_t1">｝</p>
|
|
<p>］</p>
|
|
<p>,<span>"msgTypeList"</span>:［</p>
|
|
<p>｛</p>
|
|
<p class="m_code">"SMS"</p>
|
|
<p class="l_code_t1">｝</p>
|
|
<p>,｛</p>
|
|
<p class="m_code">"SMS"</p>
|
|
<p class="l_code_t1">｝</p>
|
|
<p>］</p>
|
|
<p>,<span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"successCnt"</span>:"2"</p>
|
|
<p>,<span>"failCnt"</span>:"0"</p>
|
|
<p>,<span>"blockCnt"</span>:"0"</p>
|
|
<p>,<span>"test_yn"</span>:null</p>
|
|
<p>］</p>
|
|
</div>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"1040"</p>
|
|
<p>,<span>"data"</span>:"치환 데이터 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_3">
|
|
|
|
<ul class="info">
|
|
<li>- 문자온 사이트 및 API를 통해 전송된 문자 발송내역을 조회할 수 있습니다.</li>
|
|
<li>- 문자 발송내역은 날짜별로 조회되며, 최근 3개월까지만 조회 가능합니다.</li>
|
|
<li>- 발신번호별 문자 발송내역 조회 기능은 제공되지 않습니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>전송결과 조회 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">page</span></td>
|
|
<td>페이지 번호</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">pageSize</span></td>
|
|
<td>페이지당 출력 개수</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">startDate</span></td>
|
|
<td>시작 일자</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">endDate</span></td>
|
|
<td>마감 일자</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"홍길동"</p>
|
|
<p>,<span>"accessKey"</span>:"XXXXXXXXXXXXXX414050694b953"</p>
|
|
<p>,<span>"page"</span>:""</p>
|
|
<p>,<span>"pageSize"</span>:""</p>
|
|
<p>,<span>"startDate"</span>:""</p>
|
|
<p>,<span>"endDate"</span>:""</p>
|
|
<p>,<span>"test_yn"</span>:""</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>전송결과 조회 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].next_yn</span></td>
|
|
<td>다음 페이지 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].objectList</span></td>
|
|
<td>결과값 목록</td>
|
|
<td>Object List</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgId</span></td>
|
|
<td>메시지 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgTypeName</span></td>
|
|
<td>문자 구분명(단문, 장문, 그림)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgType</span></td>
|
|
<td>메시지 타입(4 : 단문, 5 : 장문)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].callFrom</span></td>
|
|
<td>발신자 번호</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].callTo</span></td>
|
|
<td>수신자 번호</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupCnt</span></td>
|
|
<td>문자 발송 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].sCnt</span></td>
|
|
<td>성공 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].fCnt</span></td>
|
|
<td>실패 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].wCnt</span></td>
|
|
<td>대기 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgResult</span></td>
|
|
<td>발송 결과(성공 : S, 실패 : F)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].smsTxt</span></td>
|
|
<td>문자 내용</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].subject</span></td>
|
|
<td>제목</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].reqdate</span></td>
|
|
<td>발송 일자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].curState</span></td>
|
|
<td>전송 처리 결과값</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].userId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].regdate</span></td>
|
|
<td>등록 일자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].reserveCYn</span></td>
|
|
<td>예약 취소 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].ttlCnt</span></td>
|
|
<td>전체 요청 수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].remainMsgCnt</span></td>
|
|
<td>남은 문자 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].totMsgCnt</span></td>
|
|
<td>전체 문자 개수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>:［</p>
|
|
<p>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"message"</span>: null</p>
|
|
<p>,<span>"next_yn"</span>:"n"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000000000"</p>
|
|
<p>,<span>"objectList"</span>:［</p>
|
|
<p>｛</p>
|
|
<div class="indent_t2">
|
|
<p><span>"msgTypeName"</span>:"단문(SMS)"</p>
|
|
<p>,<span>"msgType"</span>:"4"</p>
|
|
<p>,<span>"callFrom"</span>:"01011112222"</p>
|
|
<p>,<span>"callTo"</span>:"01011112223"</p>
|
|
<p>,<span>"msgGroupCnt"</span>:"2"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000013340"</p>
|
|
<p>,<span>"msgId"</span>:"MSGID_0000000000001"</p>
|
|
<p>,<span>"scnt"</span>:"2"</p>
|
|
<p>,<span>"fcnt"</span>:"0"</p>
|
|
<p>,<span>"wcnt"</span>:"0"</p>
|
|
<p>,<span>"msgResult"</span>:"S"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 내용 단문 예제"</p>
|
|
<p>,<span>"subject"</span>:null</p>
|
|
<p>,<span>"reqdate"</span>:"2023-06-13 17:48:07"</p>
|
|
<p>,<span>"curState"</span>:"3"</p>
|
|
<p>,<span>"userId"</span>:"testuser"</p>
|
|
<p>,<span>"regdate"</span>:"2023-06-13 17:48:07"</p>
|
|
<p>,<span>"reserveCYn"</span>:"N"</p>
|
|
<p>,<span>"ttlCnt"</span>:"1"</p>
|
|
<p>,<span>"remainMsgCnt"</span>:"40"</p>
|
|
<p>,<span>"totMsgCnt"</span>:"70"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
<p>,｛</p>
|
|
<div class="indent_t2">
|
|
<p><span>"msgTypeName"</span>:"장문(LMS)"</p>
|
|
<p>,<span>"msgType"</span>:"6"</p>
|
|
<p>,<span>"callFrom"</span>:"01011112222"</p>
|
|
<p>,<span>"callTo"</span>:"01011112223"</p>
|
|
<p>,<span>"msgGroupCnt"</span>:"1"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000013341"</p>
|
|
<p>,<span>"msgId"</span>:"MSGID_0000000000002"</p>
|
|
<p>,<span>"scnt"</span>:"1"</p>
|
|
<p>,<span>"fcnt"</span>:"0"</p>
|
|
<p>,<span>"wcnt"</span>:"0"</p>
|
|
<p>,<span>"msgResult"</span>:"S"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 내용 장문 예제"</p>
|
|
<p>,<span>subject"</span>:null</p>
|
|
<p>,<span>reqdate"</span>:"2023-06-02 11:46:50"</p>
|
|
<p>,<span>"curState"</span>:"3"</p>
|
|
<p>,<span>"userId"</span>:"testuser"</p>
|
|
<p>,<span>"regdate"</span>:"2023-06-02 11:46:49"</p>
|
|
<p>,<span>"reserveCYn"</span>:"N"</p>
|
|
<p>,<span>"ttlCnt"</span>:"1"</p>
|
|
<p>,<span>"remainMsgCnt"</span>:"40"</p>
|
|
<p>,<span>"totMsgCnt"</span>:"70"</p>
|
|
<p>｝</p>
|
|
</div>
|
|
<p>］</p>
|
|
</div>
|
|
<p class="l_code_t2">｝</p>
|
|
<p>］</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"3099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_4">
|
|
|
|
<ul class="info">
|
|
<li>- 전송결과 조회의 "msgGroupId"를 사용하여 전송된 문자의 상세결과를 수신번호별로 조회할 수 있습니다.</li>
|
|
<li>- 전송결과가 "대기"인 경우에는 최종 결과 확인까지 최대 72시간까지 소요됩니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>상세결과 조회 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">page</span></td>
|
|
<td>페이지 번호</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">pageSize</span></td>
|
|
<td>페이지당 출력 개수</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"홍길동"</p>
|
|
<p>,<span>"accessKey"</span>:"XXXXXXXXXXXXXX414050694b953"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000011452"</p>
|
|
<p>,<span>"page"</span>:""</p>
|
|
<p>,<span>"pageSize"</span>:""</p>
|
|
<p>,<span>"test_yn"</span>:""</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>상세결과 조회 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].next_yn</span></td>
|
|
<td>다음 페이지 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].objectList</span></td>
|
|
<td>결과값 목록</td>
|
|
<td>Object List</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgId</span></td>
|
|
<td>메시지 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgTypeName</span></td>
|
|
<td>문자 구분명(단문, 장문, 그림)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgType</span></td>
|
|
<td>메시지 타입(4 : 단문, 5 : 장문)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].callFrom</span></td>
|
|
<td>발신자 번호</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].callTo</span></td>
|
|
<td>수신자 번호</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupCnt</span></td>
|
|
<td>문자 발송 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].sCnt</span></td>
|
|
<td>성공 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].fCnt</span></td>
|
|
<td>실패 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].wCnt</span></td>
|
|
<td>대기 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgResult</span></td>
|
|
<td>발송 결과(성공 : S, 실패 : F)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].smsTxt</span></td>
|
|
<td>문자 내용</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].subject</span></td>
|
|
<td>제목</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].reqdate</span></td>
|
|
<td>발송 일자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].curState</span></td>
|
|
<td>전송 처리 결과값</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].userId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].regdate</span></td>
|
|
<td>등록 일자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].reserveCYn</span></td>
|
|
<td>예약 취소 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].ttlCnt</span></td>
|
|
<td>전체 요청 수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].remainMsgCnt</span></td>
|
|
<td>남은 문자 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].totMsgCnt</span></td>
|
|
<td>전체 문자 개수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>:［</p>
|
|
<p>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"message"</span>: null</p>
|
|
<p>,<span>"next_yn"</span>:"n"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000000000"</p>
|
|
<p>,<span>"objectList"</span>:［</p>
|
|
<p>｛</p>
|
|
<div class="indent_t2">
|
|
<p><span>"msgTypeName"</span>:"단문(SMS)"</p>
|
|
<p>,<span>"msgType"</span>:"4"</p>
|
|
<p>,<span>"callFrom"</span>:"01011112222"</p>
|
|
<p>,<span>"callTo"</span>:"01011112223"</p>
|
|
<p>,<span>"msgGroupCnt"</span>:"2"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000013340"</p>
|
|
<p>,<span>"msgId"</span>:"MSGID_0000000000001"</p>
|
|
<p>,<span>"scnt"</span>:null</p>
|
|
<p>,<span>"fcnt"</span>:null</p>
|
|
<p>,<span>"wcnt"</span>:null</p>
|
|
<p>,<span>"msgResult"</span>:"S"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 내용 단문 예제"</p>
|
|
<p>,<span>"subject"</span>:null</p>
|
|
<p>,<span>"reqdate"</span>:"2023-06-13 17:48:08"</p>
|
|
<p>,<span>"curState"</span>:"3"</p>
|
|
<p>,<span>"userId"</span>:"testuser"</p>
|
|
<p>,<span>"regdate"</span>:"2023-06-13 17:48:07"</p>
|
|
<p>,<span>"reserveCYn"</span>:"N"</p>
|
|
<p>,<span>"ttlCnt"</span>:"10"</p>
|
|
<p>,<span>"remainMsgCnt"</span>:"0"</p>
|
|
<p>,<span>"totMsgCnt"</span>:"10"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
<p>,｛</p>
|
|
<div class="indent_t2">
|
|
<p><span>"msgTypeName"</span>:"단문(SMS)"</p>
|
|
<p>,<span>"msgType"</span>:"4"</p>
|
|
<p>,<span>"callFrom"</span>:"01011112222"</p>
|
|
<p>,<span>"callTo"</span>:"01011112223"</p>
|
|
<p>,<span>"msgGroupCnt"</span>:"2"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000013340"</p>
|
|
<p>,<span>"msgId"</span>:"MSGID_0000000000002"</p>
|
|
<p>,<span>"scnt"</span>:null</p>
|
|
<p>,<span>"fcnt"</span>:null</p>
|
|
<p>,<span>"wcnt"</span>:null</p>
|
|
<p>,<span>"msgResult"</span>:"S"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 내용 단문 예제"</p>
|
|
<p>,<span>subject"</span>:null</p>
|
|
<p>,<span>reqdate"</span>:"2023-06-13 17:48:09"</p>
|
|
<p>,<span>"curState"</span>:"3"</p>
|
|
<p>,<span>"userId"</span>:"testuser"</p>
|
|
<p>,<span>"regdate"</span>:"2023-06-13 17:48:07"</p>
|
|
<p>,<span>"reserveCYn"</span>:"N"</p>
|
|
<p>,<span>"ttlCnt"</span>:"10"</p>
|
|
<p>,<span>"remainMsgCnt"</span>:"0"</p>
|
|
<p>,<span>"totMsgCnt"</span>:"10"</p>
|
|
<p>｝</p>
|
|
</div>
|
|
<p>］</p>
|
|
</div>
|
|
<p class="l_code_t2">｝</p>
|
|
<p>］</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"4099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_5">
|
|
|
|
<ul class="info">
|
|
<li>- 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다.</li>
|
|
<li>- 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"String"</p>
|
|
<p>,<span>"accessKey"</span>:"String"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longPrice</span></td>
|
|
<td>장문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longSendPsbltEa</span></td>
|
|
<td>장문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].mberMoney</span></td>
|
|
<td>현재 보유 금액</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].picturePrice</span></td>
|
|
<td>그림문자 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].pictureSendPsbltEa</span></td>
|
|
<td>그림문자 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortPrice</span></td>
|
|
<td>단문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortSendPsbltEa</span></td>
|
|
<td>단문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"longPrice"</span>:"50"</p>
|
|
<p>,<span>"longSendPsbltEa"</span>:"19651"</p>
|
|
<p>,<span>"mberMoney"</span>:"982586.7"</p>
|
|
<p>,<span>"message"</span>:null</p>
|
|
<p>,<span>"picturePrice"</span>:"90"</p>
|
|
<p>,<span>"pictureSendPsbltEa"</span>:"10917"</p>
|
|
<p>,<span>"shortPrice"</span>:"18"</p>
|
|
<p>,<span>"shortSendPsbltEa"</span>:"54588"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"5099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!-- //REST API 개발 가이드 > 문자 -->
|
|
|
|
<!-- REST API 개발 가이드 > 알림톡톡 -->
|
|
<div class="api_guide kakao" id="tab5_2">
|
|
<div class="list_tab_wrap2 type3">
|
|
<!--콘텐츠 tab button-->
|
|
<ul class="list_tab">
|
|
<li class="tab active"><button type="button" onclick="TabType2(this,'6');">채널 ID 조회</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'7');">템플릿 ID 조회</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'8');">템플릿상세조회</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'9');">알림톡 보내기</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'10');">전송내역조회</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'11');">전송내역조회(상세)</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'12');">발송가능건수</button></li>
|
|
</ul>
|
|
<!--//콘텐츠 tab button-->
|
|
</div>
|
|
|
|
<div class="api_guide_con" id="tab2_6">
|
|
|
|
<ul class="info">
|
|
<li>- API를 통해서 동일한 내용의 문자를 대량으로 전송할 수 있습니다.</li>
|
|
<li>- 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용)</li>
|
|
<li>- 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>문자발송 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callFrom</span></td>
|
|
<td>발신자 번호(아이디에 등록되어 있는 번호)</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callToList</span></td>
|
|
<td>수신자 번호(콤마(,) 기준으로 입력)</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">smsTxt</span></td>
|
|
<td>메시지 내용</td>
|
|
<td>String(1~2,000Byte)</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">nameStr</span></td>
|
|
<td>메시지 내용에 [*이름*]이 있으면 치환용 이름 입력( | 로 구분 )</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
<p>※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"홍길동"</p>
|
|
<p>,<span>"accessKey"</span>:"XXXXXXXXXXXXXX414050694b953"</p>
|
|
<p>,<span>"callFrom"</span>:"01012341234"</p>
|
|
<p>,<span>"callToList"</span>:"01011111111,01022222222,01033333333"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 테스트~![*이름*]"</p>
|
|
<p>,<span>"nameStr"</span>:"홍길동1|홍길동2|홍길동3"</p>
|
|
<p>,<span>"test_yn"</span>:""</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>문자발송 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgType</span></td>
|
|
<td>메시지 타입(4 : 단문, 5 : 장문)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].blockCnt</span></td>
|
|
<td>수신거부 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].failCnt</span></td>
|
|
<td>전송 실패 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].successCnt</span></td>
|
|
<td>성공 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"msgGroupId"</span>:"MSGGID_0000000000000"</p>
|
|
<p>,<span>"msgType"</span>:"SMS"</p>
|
|
<p>,<span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"blockCnt"</span>:"0"</p>
|
|
<p>,<span>"failCnt"</span>:"0"</p>
|
|
<p>,<span>"successCnt"</span>:"3"</p>
|
|
<p>,<span>"test_yn"</span>:null</p>
|
|
</div>
|
|
<p>｝</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"1040"</p>
|
|
<p>,<span>"data"</span>:"치환 데이터 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_7">
|
|
|
|
<ul class="info">
|
|
<li>- API를 통해서 다른 내용의 문자를 대량으로 전송할 수 있습니다.</li>
|
|
<li>- 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용)</li>
|
|
<li>- 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>문자발송(대량) API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callFrom</span></td>
|
|
<td>발신자 번호(아이디에 등록되어 있는 번호)</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callTo_1</span></td>
|
|
<td>수신자 번호 1</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">smsTxt_1</span></td>
|
|
<td>메시지 내용 1 </td>
|
|
<td>String(1~2,000Byte)</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">...</span></td>
|
|
<td>...</td>
|
|
<td>...</td>
|
|
<td><span class="select_o">...</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callTo_100</span></td>
|
|
<td>수신자 번호 100</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">smsTxt_100</span></td>
|
|
<td>메시지 내용 100</td>
|
|
<td>String(1~2,000Byte)</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"홍길동"</p>
|
|
<p>,<span>"accessKey"</span>:"XXXXXXXXXXXXXX414050694b953"</p>
|
|
<p>,<span>"callFrom"</span>:"01012341234"</p>
|
|
<p>,<span>"test_yn"</span>:""</p>
|
|
<p>,<span>"callTo_1"</span>:"01011111111"</p>
|
|
<p>,<span>"smsTxt_1"</span>:"문자 테스트 1"</p>
|
|
<p>,<span>"callTo_2"</span>:"01022222222"</p>
|
|
<p>,<span>"smsTxt_2"</span>:"문자 테스트 2"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>문자발송(대량) API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupIdList</span></td>
|
|
<td>메시지 그룹 ID 리스트</td>
|
|
<td>List String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgType</span></td>
|
|
<td>메시지 타입(4 : 단문, 5 : 장문)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].blockCnt</span></td>
|
|
<td>수신거부 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].failCnt</span></td>
|
|
<td>전송 실패 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].successCnt</span></td>
|
|
<td>성공 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>:［</p>
|
|
<div class="indent_t1">
|
|
<p><span>"msgGroupIdList"</span>:［</p>
|
|
<p>｛</p>
|
|
<p class="m_code">"MSGGID_0000000013451"</p>
|
|
<p class="l_code_t1">｝</p>
|
|
<p>,｛</p>
|
|
<p class="m_code">"MSGGID_0000000013452"</p>
|
|
<p class="l_code_t1">｝</p>
|
|
<p>］</p>
|
|
<p>,<span>"msgTypeList"</span>:［</p>
|
|
<p>｛</p>
|
|
<p class="m_code">"SMS"</p>
|
|
<p class="l_code_t1">｝</p>
|
|
<p>,｛</p>
|
|
<p class="m_code">"SMS"</p>
|
|
<p class="l_code_t1">｝</p>
|
|
<p>］</p>
|
|
<p>,<span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"successCnt"</span>:"2"</p>
|
|
<p>,<span>"failCnt"</span>:"0"</p>
|
|
<p>,<span>"blockCnt"</span>:"0"</p>
|
|
<p>,<span>"test_yn"</span>:null</p>
|
|
<p>］</p>
|
|
</div>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"1040"</p>
|
|
<p>,<span>"data"</span>:"치환 데이터 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_8">
|
|
|
|
<ul class="info">
|
|
<li>- 문자온 사이트 및 API를 통해 전송된 문자 발송내역을 조회할 수 있습니다.</li>
|
|
<li>- 문자 발송내역은 날짜별로 조회되며, 최근 3개월까지만 조회 가능합니다.</li>
|
|
<li>- 발신번호별 문자 발송내역 조회 기능은 제공되지 않습니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>전송결과 조회 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">page</span></td>
|
|
<td>페이지 번호</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">pageSize</span></td>
|
|
<td>페이지당 출력 개수</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">startDate</span></td>
|
|
<td>시작 일자</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">endDate</span></td>
|
|
<td>마감 일자</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"홍길동"</p>
|
|
<p>,<span>"accessKey"</span>:"XXXXXXXXXXXXXX414050694b953"</p>
|
|
<p>,<span>"page"</span>:""</p>
|
|
<p>,<span>"pageSize"</span>:""</p>
|
|
<p>,<span>"startDate"</span>:""</p>
|
|
<p>,<span>"endDate"</span>:""</p>
|
|
<p>,<span>"test_yn"</span>:""</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>전송결과 조회 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].next_yn</span></td>
|
|
<td>다음 페이지 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].objectList</span></td>
|
|
<td>결과값 목록</td>
|
|
<td>Object List</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgId</span></td>
|
|
<td>메시지 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgTypeName</span></td>
|
|
<td>문자 구분명(단문, 장문, 그림)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgType</span></td>
|
|
<td>메시지 타입(4 : 단문, 5 : 장문)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].callFrom</span></td>
|
|
<td>발신자 번호</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].callTo</span></td>
|
|
<td>수신자 번호</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupCnt</span></td>
|
|
<td>문자 발송 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].sCnt</span></td>
|
|
<td>성공 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].fCnt</span></td>
|
|
<td>실패 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].wCnt</span></td>
|
|
<td>대기 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgResult</span></td>
|
|
<td>발송 결과(성공 : S, 실패 : F)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].smsTxt</span></td>
|
|
<td>문자 내용</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].subject</span></td>
|
|
<td>제목</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].reqdate</span></td>
|
|
<td>발송 일자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].curState</span></td>
|
|
<td>전송 처리 결과값</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].userId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].regdate</span></td>
|
|
<td>등록 일자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].reserveCYn</span></td>
|
|
<td>예약 취소 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].ttlCnt</span></td>
|
|
<td>전체 요청 수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].remainMsgCnt</span></td>
|
|
<td>남은 문자 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].totMsgCnt</span></td>
|
|
<td>전체 문자 개수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>:［</p>
|
|
<p>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"message"</span>: null</p>
|
|
<p>,<span>"next_yn"</span>:"n"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000000000"</p>
|
|
<p>,<span>"objectList"</span>:［</p>
|
|
<p>｛</p>
|
|
<div class="indent_t2">
|
|
<p><span>"msgTypeName"</span>:"단문(SMS)"</p>
|
|
<p>,<span>"msgType"</span>:"4"</p>
|
|
<p>,<span>"callFrom"</span>:"01011112222"</p>
|
|
<p>,<span>"callTo"</span>:"01011112223"</p>
|
|
<p>,<span>"msgGroupCnt"</span>:"2"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000013340"</p>
|
|
<p>,<span>"msgId"</span>:"MSGID_0000000000001"</p>
|
|
<p>,<span>"scnt"</span>:"2"</p>
|
|
<p>,<span>"fcnt"</span>:"0"</p>
|
|
<p>,<span>"wcnt"</span>:"0"</p>
|
|
<p>,<span>"msgResult"</span>:"S"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 내용 단문 예제"</p>
|
|
<p>,<span>"subject"</span>:null</p>
|
|
<p>,<span>"reqdate"</span>:"2023-06-13 17:48:07"</p>
|
|
<p>,<span>"curState"</span>:"3"</p>
|
|
<p>,<span>"userId"</span>:"testuser"</p>
|
|
<p>,<span>"regdate"</span>:"2023-06-13 17:48:07"</p>
|
|
<p>,<span>"reserveCYn"</span>:"N"</p>
|
|
<p>,<span>"ttlCnt"</span>:"1"</p>
|
|
<p>,<span>"remainMsgCnt"</span>:"40"</p>
|
|
<p>,<span>"totMsgCnt"</span>:"70"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
<p>,｛</p>
|
|
<div class="indent_t2">
|
|
<p><span>"msgTypeName"</span>:"장문(LMS)"</p>
|
|
<p>,<span>"msgType"</span>:"6"</p>
|
|
<p>,<span>"callFrom"</span>:"01011112222"</p>
|
|
<p>,<span>"callTo"</span>:"01011112223"</p>
|
|
<p>,<span>"msgGroupCnt"</span>:"1"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000013341"</p>
|
|
<p>,<span>"msgId"</span>:"MSGID_0000000000002"</p>
|
|
<p>,<span>"scnt"</span>:"1"</p>
|
|
<p>,<span>"fcnt"</span>:"0"</p>
|
|
<p>,<span>"wcnt"</span>:"0"</p>
|
|
<p>,<span>"msgResult"</span>:"S"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 내용 장문 예제"</p>
|
|
<p>,<span>subject"</span>:null</p>
|
|
<p>,<span>reqdate"</span>:"2023-06-02 11:46:50"</p>
|
|
<p>,<span>"curState"</span>:"3"</p>
|
|
<p>,<span>"userId"</span>:"testuser"</p>
|
|
<p>,<span>"regdate"</span>:"2023-06-02 11:46:49"</p>
|
|
<p>,<span>"reserveCYn"</span>:"N"</p>
|
|
<p>,<span>"ttlCnt"</span>:"1"</p>
|
|
<p>,<span>"remainMsgCnt"</span>:"40"</p>
|
|
<p>,<span>"totMsgCnt"</span>:"70"</p>
|
|
<p>｝</p>
|
|
</div>
|
|
<p>］</p>
|
|
</div>
|
|
<p class="l_code_t2">｝</p>
|
|
<p>］</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"3099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_9">
|
|
|
|
<ul class="info">
|
|
<li>- 전송결과 조회의 "msgGroupId"를 사용하여 전송된 문자의 상세결과를 수신번호별로 조회할 수 있습니다.</li>
|
|
<li>- 전송결과가 "대기"인 경우에는 최종 결과 확인까지 최대 72시간까지 소요됩니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>상세결과 조회 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">page</span></td>
|
|
<td>페이지 번호</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">pageSize</span></td>
|
|
<td>페이지당 출력 개수</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"홍길동"</p>
|
|
<p>,<span>"accessKey"</span>:"XXXXXXXXXXXXXX414050694b953"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000011452"</p>
|
|
<p>,<span>"page"</span>:""</p>
|
|
<p>,<span>"pageSize"</span>:""</p>
|
|
<p>,<span>"test_yn"</span>:""</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>상세결과 조회 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].next_yn</span></td>
|
|
<td>다음 페이지 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].objectList</span></td>
|
|
<td>결과값 목록</td>
|
|
<td>Object List</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgId</span></td>
|
|
<td>메시지 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgTypeName</span></td>
|
|
<td>문자 구분명(단문, 장문, 그림)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgType</span></td>
|
|
<td>메시지 타입(4 : 단문, 5 : 장문)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].callFrom</span></td>
|
|
<td>발신자 번호</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].callTo</span></td>
|
|
<td>수신자 번호</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupCnt</span></td>
|
|
<td>문자 발송 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].sCnt</span></td>
|
|
<td>성공 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].fCnt</span></td>
|
|
<td>실패 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].wCnt</span></td>
|
|
<td>대기 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgResult</span></td>
|
|
<td>발송 결과(성공 : S, 실패 : F)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].smsTxt</span></td>
|
|
<td>문자 내용</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].subject</span></td>
|
|
<td>제목</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].reqdate</span></td>
|
|
<td>발송 일자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].curState</span></td>
|
|
<td>전송 처리 결과값</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].userId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].regdate</span></td>
|
|
<td>등록 일자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].reserveCYn</span></td>
|
|
<td>예약 취소 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].ttlCnt</span></td>
|
|
<td>전체 요청 수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].remainMsgCnt</span></td>
|
|
<td>남은 문자 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].totMsgCnt</span></td>
|
|
<td>전체 문자 개수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>:［</p>
|
|
<p>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"message"</span>: null</p>
|
|
<p>,<span>"next_yn"</span>:"n"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000000000"</p>
|
|
<p>,<span>"objectList"</span>:［</p>
|
|
<p>｛</p>
|
|
<div class="indent_t2">
|
|
<p><span>"msgTypeName"</span>:"단문(SMS)"</p>
|
|
<p>,<span>"msgType"</span>:"4"</p>
|
|
<p>,<span>"callFrom"</span>:"01011112222"</p>
|
|
<p>,<span>"callTo"</span>:"01011112223"</p>
|
|
<p>,<span>"msgGroupCnt"</span>:"2"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000013340"</p>
|
|
<p>,<span>"msgId"</span>:"MSGID_0000000000001"</p>
|
|
<p>,<span>"scnt"</span>:null</p>
|
|
<p>,<span>"fcnt"</span>:null</p>
|
|
<p>,<span>"wcnt"</span>:null</p>
|
|
<p>,<span>"msgResult"</span>:"S"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 내용 단문 예제"</p>
|
|
<p>,<span>"subject"</span>:null</p>
|
|
<p>,<span>"reqdate"</span>:"2023-06-13 17:48:08"</p>
|
|
<p>,<span>"curState"</span>:"3"</p>
|
|
<p>,<span>"userId"</span>:"testuser"</p>
|
|
<p>,<span>"regdate"</span>:"2023-06-13 17:48:07"</p>
|
|
<p>,<span>"reserveCYn"</span>:"N"</p>
|
|
<p>,<span>"ttlCnt"</span>:"10"</p>
|
|
<p>,<span>"remainMsgCnt"</span>:"0"</p>
|
|
<p>,<span>"totMsgCnt"</span>:"10"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
<p>,｛</p>
|
|
<div class="indent_t2">
|
|
<p><span>"msgTypeName"</span>:"단문(SMS)"</p>
|
|
<p>,<span>"msgType"</span>:"4"</p>
|
|
<p>,<span>"callFrom"</span>:"01011112222"</p>
|
|
<p>,<span>"callTo"</span>:"01011112223"</p>
|
|
<p>,<span>"msgGroupCnt"</span>:"2"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000013340"</p>
|
|
<p>,<span>"msgId"</span>:"MSGID_0000000000002"</p>
|
|
<p>,<span>"scnt"</span>:null</p>
|
|
<p>,<span>"fcnt"</span>:null</p>
|
|
<p>,<span>"wcnt"</span>:null</p>
|
|
<p>,<span>"msgResult"</span>:"S"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 내용 단문 예제"</p>
|
|
<p>,<span>subject"</span>:null</p>
|
|
<p>,<span>reqdate"</span>:"2023-06-13 17:48:09"</p>
|
|
<p>,<span>"curState"</span>:"3"</p>
|
|
<p>,<span>"userId"</span>:"testuser"</p>
|
|
<p>,<span>"regdate"</span>:"2023-06-13 17:48:07"</p>
|
|
<p>,<span>"reserveCYn"</span>:"N"</p>
|
|
<p>,<span>"ttlCnt"</span>:"10"</p>
|
|
<p>,<span>"remainMsgCnt"</span>:"0"</p>
|
|
<p>,<span>"totMsgCnt"</span>:"10"</p>
|
|
<p>｝</p>
|
|
</div>
|
|
<p>］</p>
|
|
</div>
|
|
<p class="l_code_t2">｝</p>
|
|
<p>］</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"4099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_10">
|
|
|
|
<ul class="info">
|
|
<li>- 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다.</li>
|
|
<li>- 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"String"</p>
|
|
<p>,<span>"accessKey"</span>:"String"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longPrice</span></td>
|
|
<td>장문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longSendPsbltEa</span></td>
|
|
<td>장문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].mberMoney</span></td>
|
|
<td>현재 보유 금액</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].picturePrice</span></td>
|
|
<td>그림문자 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].pictureSendPsbltEa</span></td>
|
|
<td>그림문자 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortPrice</span></td>
|
|
<td>단문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortSendPsbltEa</span></td>
|
|
<td>단문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"longPrice"</span>:"50"</p>
|
|
<p>,<span>"longSendPsbltEa"</span>:"19651"</p>
|
|
<p>,<span>"mberMoney"</span>:"982586.7"</p>
|
|
<p>,<span>"message"</span>:null</p>
|
|
<p>,<span>"picturePrice"</span>:"90"</p>
|
|
<p>,<span>"pictureSendPsbltEa"</span>:"10917"</p>
|
|
<p>,<span>"shortPrice"</span>:"18"</p>
|
|
<p>,<span>"shortSendPsbltEa"</span>:"54588"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"5099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_11">
|
|
|
|
<ul class="info">
|
|
<li>- 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다.</li>
|
|
<li>- 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"String"</p>
|
|
<p>,<span>"accessKey"</span>:"String"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longPrice</span></td>
|
|
<td>장문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longSendPsbltEa</span></td>
|
|
<td>장문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].mberMoney</span></td>
|
|
<td>현재 보유 금액</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].picturePrice</span></td>
|
|
<td>그림문자 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].pictureSendPsbltEa</span></td>
|
|
<td>그림문자 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortPrice</span></td>
|
|
<td>단문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortSendPsbltEa</span></td>
|
|
<td>단문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"longPrice"</span>:"50"</p>
|
|
<p>,<span>"longSendPsbltEa"</span>:"19651"</p>
|
|
<p>,<span>"mberMoney"</span>:"982586.7"</p>
|
|
<p>,<span>"message"</span>:null</p>
|
|
<p>,<span>"picturePrice"</span>:"90"</p>
|
|
<p>,<span>"pictureSendPsbltEa"</span>:"10917"</p>
|
|
<p>,<span>"shortPrice"</span>:"18"</p>
|
|
<p>,<span>"shortSendPsbltEa"</span>:"54588"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"5099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_12">
|
|
|
|
<ul class="info">
|
|
<li>- 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다.</li>
|
|
<li>- 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"String"</p>
|
|
<p>,<span>"accessKey"</span>:"String"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longPrice</span></td>
|
|
<td>장문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longSendPsbltEa</span></td>
|
|
<td>장문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].mberMoney</span></td>
|
|
<td>현재 보유 금액</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].picturePrice</span></td>
|
|
<td>그림문자 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].pictureSendPsbltEa</span></td>
|
|
<td>그림문자 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortPrice</span></td>
|
|
<td>단문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortSendPsbltEa</span></td>
|
|
<td>단문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"longPrice"</span>:"50"</p>
|
|
<p>,<span>"longSendPsbltEa"</span>:"19651"</p>
|
|
<p>,<span>"mberMoney"</span>:"982586.7"</p>
|
|
<p>,<span>"message"</span>:null</p>
|
|
<p>,<span>"picturePrice"</span>:"90"</p>
|
|
<p>,<span>"pictureSendPsbltEa"</span>:"10917"</p>
|
|
<p>,<span>"shortPrice"</span>:"18"</p>
|
|
<p>,<span>"shortSendPsbltEa"</span>:"54588"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"5099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!-- //REST API 개발 가이드 > 알림톡 -->
|
|
|
|
<!-- REST API 개발 가이드 > 친구톡 -->
|
|
<div class="api_guide kakao" id="tab5_3">
|
|
<div class="list_tab_wrap2 type3">
|
|
<!--콘텐츠 tab button-->
|
|
<ul class="list_tab">
|
|
<li class="tab active"><button type="button" onclick="TabType2(this,'13');">채널 ID 조회</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'14');">친구톡보내기</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'15');">전송내역조회</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'16');">전송내역조회(상세)</button></li>
|
|
<li class="tab"><button type="button" onclick="TabType2(this,'17');">발송가능건수</button></li>
|
|
</ul>
|
|
<!--//콘텐츠 tab button-->
|
|
</div>
|
|
|
|
<div class="api_guide_con" id="tab2_13">
|
|
|
|
<ul class="info">
|
|
<li>- API를 통해서 동일한 내용의 문자를 대량으로 전송할 수 있습니다.</li>
|
|
<li>- 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용)</li>
|
|
<li>- 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>문자발송 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callFrom</span></td>
|
|
<td>발신자 번호(아이디에 등록되어 있는 번호)</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">callToList</span></td>
|
|
<td>수신자 번호(콤마(,) 기준으로 입력)</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">smsTxt</span></td>
|
|
<td>메시지 내용</td>
|
|
<td>String(1~2,000Byte)</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">nameStr</span></td>
|
|
<td>메시지 내용에 [*이름*]이 있으면 치환용 이름 입력( | 로 구분 )</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
<p>※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"홍길동"</p>
|
|
<p>,<span>"accessKey"</span>:"XXXXXXXXXXXXXX414050694b953"</p>
|
|
<p>,<span>"callFrom"</span>:"01012341234"</p>
|
|
<p>,<span>"callToList"</span>:"01011111111,01022222222,01033333333"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 테스트~![*이름*]"</p>
|
|
<p>,<span>"nameStr"</span>:"홍길동1|홍길동2|홍길동3"</p>
|
|
<p>,<span>"test_yn"</span>:""</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>문자발송 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgType</span></td>
|
|
<td>메시지 타입(4 : 단문, 5 : 장문)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].blockCnt</span></td>
|
|
<td>수신거부 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].failCnt</span></td>
|
|
<td>전송 실패 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].successCnt</span></td>
|
|
<td>성공 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"msgGroupId"</span>:"MSGGID_0000000000000"</p>
|
|
<p>,<span>"msgType"</span>:"SMS"</p>
|
|
<p>,<span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"blockCnt"</span>:"0"</p>
|
|
<p>,<span>"failCnt"</span>:"0"</p>
|
|
<p>,<span>"successCnt"</span>:"3"</p>
|
|
<p>,<span>"test_yn"</span>:null</p>
|
|
</div>
|
|
<p>｝</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"1040"</p>
|
|
<p>,<span>"data"</span>:"치환 데이터 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_14">
|
|
|
|
<ul class="info">
|
|
<li>- 전송결과 조회의 "msgGroupId"를 사용하여 전송된 문자의 상세결과를 수신번호별로 조회할 수 있습니다.</li>
|
|
<li>- 전송결과가 "대기"인 경우에는 최종 결과 확인까지 최대 72시간까지 소요됩니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>상세결과 조회 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">page</span></td>
|
|
<td>페이지 번호</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">pageSize</span></td>
|
|
<td>페이지당 출력 개수</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">test_yn</span></td>
|
|
<td>테스트 데이터 여부</td>
|
|
<td>String</td>
|
|
<td><span class="select_x">X</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"홍길동"</p>
|
|
<p>,<span>"accessKey"</span>:"XXXXXXXXXXXXXX414050694b953"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000011452"</p>
|
|
<p>,<span>"page"</span>:""</p>
|
|
<p>,<span>"pageSize"</span>:""</p>
|
|
<p>,<span>"test_yn"</span>:""</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>상세결과 조회 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].next_yn</span></td>
|
|
<td>다음 페이지 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].objectList</span></td>
|
|
<td>결과값 목록</td>
|
|
<td>Object List</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupId</span></td>
|
|
<td>메시지 그룹 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgId</span></td>
|
|
<td>메시지 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgTypeName</span></td>
|
|
<td>문자 구분명(단문, 장문, 그림)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgType</span></td>
|
|
<td>메시지 타입(4 : 단문, 5 : 장문)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].callFrom</span></td>
|
|
<td>발신자 번호</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].callTo</span></td>
|
|
<td>수신자 번호</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgGroupCnt</span></td>
|
|
<td>문자 발송 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].sCnt</span></td>
|
|
<td>성공 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].fCnt</span></td>
|
|
<td>실패 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].wCnt</span></td>
|
|
<td>대기 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].msgResult</span></td>
|
|
<td>발송 결과(성공 : S, 실패 : F)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].smsTxt</span></td>
|
|
<td>문자 내용</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].subject</span></td>
|
|
<td>제목</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].reqdate</span></td>
|
|
<td>발송 일자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].curState</span></td>
|
|
<td>전송 처리 결과값</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].userId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].regdate</span></td>
|
|
<td>등록 일자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].reserveCYn</span></td>
|
|
<td>예약 취소 여부</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].ttlCnt</span></td>
|
|
<td>전체 요청 수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].remainMsgCnt</span></td>
|
|
<td>남은 문자 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].totMsgCnt</span></td>
|
|
<td>전체 문자 개수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>:［</p>
|
|
<p>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"message"</span>: null</p>
|
|
<p>,<span>"next_yn"</span>:"n"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000000000"</p>
|
|
<p>,<span>"objectList"</span>:［</p>
|
|
<p>｛</p>
|
|
<div class="indent_t2">
|
|
<p><span>"msgTypeName"</span>:"단문(SMS)"</p>
|
|
<p>,<span>"msgType"</span>:"4"</p>
|
|
<p>,<span>"callFrom"</span>:"01011112222"</p>
|
|
<p>,<span>"callTo"</span>:"01011112223"</p>
|
|
<p>,<span>"msgGroupCnt"</span>:"2"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000013340"</p>
|
|
<p>,<span>"msgId"</span>:"MSGID_0000000000001"</p>
|
|
<p>,<span>"scnt"</span>:null</p>
|
|
<p>,<span>"fcnt"</span>:null</p>
|
|
<p>,<span>"wcnt"</span>:null</p>
|
|
<p>,<span>"msgResult"</span>:"S"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 내용 단문 예제"</p>
|
|
<p>,<span>"subject"</span>:null</p>
|
|
<p>,<span>"reqdate"</span>:"2023-06-13 17:48:08"</p>
|
|
<p>,<span>"curState"</span>:"3"</p>
|
|
<p>,<span>"userId"</span>:"testuser"</p>
|
|
<p>,<span>"regdate"</span>:"2023-06-13 17:48:07"</p>
|
|
<p>,<span>"reserveCYn"</span>:"N"</p>
|
|
<p>,<span>"ttlCnt"</span>:"10"</p>
|
|
<p>,<span>"remainMsgCnt"</span>:"0"</p>
|
|
<p>,<span>"totMsgCnt"</span>:"10"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
<p>,｛</p>
|
|
<div class="indent_t2">
|
|
<p><span>"msgTypeName"</span>:"단문(SMS)"</p>
|
|
<p>,<span>"msgType"</span>:"4"</p>
|
|
<p>,<span>"callFrom"</span>:"01011112222"</p>
|
|
<p>,<span>"callTo"</span>:"01011112223"</p>
|
|
<p>,<span>"msgGroupCnt"</span>:"2"</p>
|
|
<p>,<span>"msgGroupId"</span>:"MSGGID_0000000013340"</p>
|
|
<p>,<span>"msgId"</span>:"MSGID_0000000000002"</p>
|
|
<p>,<span>"scnt"</span>:null</p>
|
|
<p>,<span>"fcnt"</span>:null</p>
|
|
<p>,<span>"wcnt"</span>:null</p>
|
|
<p>,<span>"msgResult"</span>:"S"</p>
|
|
<p>,<span>"smsTxt"</span>:"문자 내용 단문 예제"</p>
|
|
<p>,<span>subject"</span>:null</p>
|
|
<p>,<span>reqdate"</span>:"2023-06-13 17:48:09"</p>
|
|
<p>,<span>"curState"</span>:"3"</p>
|
|
<p>,<span>"userId"</span>:"testuser"</p>
|
|
<p>,<span>"regdate"</span>:"2023-06-13 17:48:07"</p>
|
|
<p>,<span>"reserveCYn"</span>:"N"</p>
|
|
<p>,<span>"ttlCnt"</span>:"10"</p>
|
|
<p>,<span>"remainMsgCnt"</span>:"0"</p>
|
|
<p>,<span>"totMsgCnt"</span>:"10"</p>
|
|
<p>｝</p>
|
|
</div>
|
|
<p>］</p>
|
|
</div>
|
|
<p class="l_code_t2">｝</p>
|
|
<p>］</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"4099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_15">
|
|
|
|
<ul class="info">
|
|
<li>- 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다.</li>
|
|
<li>- 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"String"</p>
|
|
<p>,<span>"accessKey"</span>:"String"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longPrice</span></td>
|
|
<td>장문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longSendPsbltEa</span></td>
|
|
<td>장문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].mberMoney</span></td>
|
|
<td>현재 보유 금액</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].picturePrice</span></td>
|
|
<td>그림문자 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].pictureSendPsbltEa</span></td>
|
|
<td>그림문자 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortPrice</span></td>
|
|
<td>단문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortSendPsbltEa</span></td>
|
|
<td>단문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"longPrice"</span>:"50"</p>
|
|
<p>,<span>"longSendPsbltEa"</span>:"19651"</p>
|
|
<p>,<span>"mberMoney"</span>:"982586.7"</p>
|
|
<p>,<span>"message"</span>:null</p>
|
|
<p>,<span>"picturePrice"</span>:"90"</p>
|
|
<p>,<span>"pictureSendPsbltEa"</span>:"10917"</p>
|
|
<p>,<span>"shortPrice"</span>:"18"</p>
|
|
<p>,<span>"shortSendPsbltEa"</span>:"54588"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"5099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_16">
|
|
|
|
<ul class="info">
|
|
<li>- 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다.</li>
|
|
<li>- 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"String"</p>
|
|
<p>,<span>"accessKey"</span>:"String"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longPrice</span></td>
|
|
<td>장문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longSendPsbltEa</span></td>
|
|
<td>장문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].mberMoney</span></td>
|
|
<td>현재 보유 금액</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].picturePrice</span></td>
|
|
<td>그림문자 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].pictureSendPsbltEa</span></td>
|
|
<td>그림문자 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortPrice</span></td>
|
|
<td>단문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortSendPsbltEa</span></td>
|
|
<td>단문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"longPrice"</span>:"50"</p>
|
|
<p>,<span>"longSendPsbltEa"</span>:"19651"</p>
|
|
<p>,<span>"mberMoney"</span>:"982586.7"</p>
|
|
<p>,<span>"message"</span>:null</p>
|
|
<p>,<span>"picturePrice"</span>:"90"</p>
|
|
<p>,<span>"pictureSendPsbltEa"</span>:"10917"</p>
|
|
<p>,<span>"shortPrice"</span>:"18"</p>
|
|
<p>,<span>"shortSendPsbltEa"</span>:"54588"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"5099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
</div>
|
|
<div class="api_guide_con" id="tab2_17">
|
|
|
|
<ul class="info">
|
|
<li>- 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다.</li>
|
|
<li>- 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다.</li>
|
|
</ul>
|
|
|
|
<div class="re_cont">
|
|
<!--Request-->
|
|
<div class="req_title">Request</div>
|
|
<div class="box">
|
|
<div class="text">
|
|
<h4>Request</h4>
|
|
<table>
|
|
<caption>API Request Http Method, 프로토콜, HOST, Service Port 정보 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:80%;">
|
|
</colgroup>
|
|
<tr>
|
|
<th>Http Method</th>
|
|
<td>POST</td>
|
|
</tr>
|
|
<tr>
|
|
<th>프로토콜</th>
|
|
<td>HHTP/1.1</td>
|
|
</tr>
|
|
<tr>
|
|
<th>HOST</th>
|
|
<td>api.munjaon.co.kr</td>
|
|
</tr>
|
|
<tr>
|
|
<th>Service Port</th>
|
|
<td>443</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Request 키 종류 및 설명, 타입, 필수 여부 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:45%;">
|
|
<col style="width:25%">
|
|
<col style="width:10%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
<th>필수</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">mberId</span></td>
|
|
<td>사용자 ID</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">accessKey</span></td>
|
|
<td>인증용 API Key</td>
|
|
<td>String</td>
|
|
<td><span class="select_o">O</span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title">[Example]</div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"mberId"</span>:"String"</p>
|
|
<p>,<span>"accessKey"</span>:"String"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Request-->
|
|
<!-- Response-->
|
|
<div class="res_title">Response</div>
|
|
<div class="type_table">
|
|
<table>
|
|
<caption>발송가능 건수 API Response 키 종류 및 설명, 타입 테이블</caption>
|
|
<colgroup>
|
|
<col style="width:20%;">
|
|
<col style="width:60%;">
|
|
<col style="width:20%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th>키</th>
|
|
<th>설명</th>
|
|
<th>타입</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="font_b">resultCode</span></td>
|
|
<td>성공 여부("0" 아니면 실패)</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">data</span></td>
|
|
<td>결과값 객체(성공 : 데이터, 실패 : 메시지)</td>
|
|
<td>Object</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longPrice</span></td>
|
|
<td>장문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].longSendPsbltEa</span></td>
|
|
<td>장문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].mberMoney</span></td>
|
|
<td>현재 보유 금액</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].message</span></td>
|
|
<td>문자</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].picturePrice</span></td>
|
|
<td>그림문자 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].pictureSendPsbltEa</span></td>
|
|
<td>그림문자 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortPrice</span></td>
|
|
<td>단문 단가</td>
|
|
<td>String</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="font_b">[data].shortSendPsbltEa</span></td>
|
|
<td>단문 발송 가능 건수</td>
|
|
<td>String</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="table_info">
|
|
<p>※ JSON 객체로 응답합니다.</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_success">O 성공 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"0"</p>
|
|
<p>,<span>"data"</span>｛</p>
|
|
<div class="indent_t1">
|
|
<p><span>"longPrice"</span>:"50"</p>
|
|
<p>,<span>"longSendPsbltEa"</span>:"19651"</p>
|
|
<p>,<span>"mberMoney"</span>:"982586.7"</p>
|
|
<p>,<span>"message"</span>:null</p>
|
|
<p>,<span>"picturePrice"</span>:"90"</p>
|
|
<p>,<span>"pictureSendPsbltEa"</span>:"10917"</p>
|
|
<p>,<span>"shortPrice"</span>:"18"</p>
|
|
<p>,<span>"shortSendPsbltEa"</span>:"54588"</p>
|
|
</div>
|
|
<p>｝</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<div class="box">
|
|
<div class="title_t1"><span class="ex">[Example]</span><span class="ex_fail">X 실패 예시</span></div>
|
|
<div class="code_view">
|
|
<p>｛</p>
|
|
<div class="indent">
|
|
<p><span>"resultCode"</span>:"5099"</p>
|
|
<p>,<span>"data"</span>:"기타 시스템 오류"</p>
|
|
</div>
|
|
<p class="l_code">｝</p>
|
|
</div>
|
|
</div>
|
|
<!--// Response-->
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!-- //REST API 개발 가이드 > 친구톡 -->
|
|
|
|
|
|
<!--// 사용안내 내용-->
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!--// send top -->
|
|
</div>
|
|
</div>
|
|
<!--// content 영역 -->
|
|
<!-- footer -->
|
|
<div data-include-path="/publish/layout/_footer.html"></div>
|
|
<!--// footer 영역 -->
|
|
</body>
|
|
|
|
</html> |