JSP Example
-| jsp_example_send_msg_r1.jsp | -문자보내기(여러명에게 동일한문자) | -
|---|---|
| sp_example_send_msgs_r1.jsp | -문자보내기(여러명에게 다른문자) | -
| jsp_example_hstry_r1.jsp | -전송내역조회 | -
| jsp_example_hstry_detail_r1.jsp | -상세전송내역조회 | -
| jsp_example_select_price_r1.jsp | -발송가능건수 | -
+
@@ -223,8 +223,8 @@
-
-
-
+
+
+
diff --git a/src/main/webapp/publish/api_download.html b/src/main/webapp/publish/api_download.html
index 5015f810..b7fa98ee 100644
--- a/src/main/webapp/publish/api_download.html
+++ b/src/main/webapp/publish/api_download.html
@@ -181,8 +181,8 @@
-
+
- - 서비스 사용 신청 시, 문자 및 카카오톡 연동서비스를 모두 이용하실 수 있습니다. +
- - 관리자 승인 이후 발송 서버 IP를 등록해 주셔야 합니다. +
API 신청 정보
+
+
- -
+
- + + +
- + + +
-
-
-
-
-
-
-
-
-
-
-
-
- ASP Example
-| 파일명 | -파일 설명 | -
|---|---|
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
-
-
-
-
-
-
+
-
-
+
+ PHP Example
-| php_example_send_msg_r1.php | +jsp_example_send_msg_r1.jsp | 문자보내기(여러명에게 동일한문자) |
|---|---|---|
| php_example_send_msgs_r1.php | +sp_example_send_msgs_r1.jsp | 문자보내기(여러명에게 다른문자) |
| php_example_hstry_r1.php | +jsp_example_hstry_r1.jsp | 전송내역조회 |
| php_example_hstry_detail_r1.php | +jsp_example_hstry_detail_r1.jsp | 상세전송내역조회 |
| php_example_select_price_r1.php | +jsp_example_select_price_r1.jsp | 발송가능건수 |
+
-
-
-
-
-
-
-
+
+
-
-
+
+
+
-
-
- .NET Example
-| 파일명 | -파일 설명 | -
|---|---|
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
+
-
+
+
+
+
+
+ ASP Example
+| 파일명 | +파일 설명 | +
|---|---|
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
+
-
-
-
-
@@ -148,11 +145,9 @@
- -
- 채 팅상담
+ 채 팅상담
-
@@ -95,8 +95,7 @@
-
+
-
-
+
+
+
-
-
- AOS Example
-| 파일명 | -파일 설명 | -
|---|---|
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
+
-
+
+
+
+
+
+ PHP Example
+| php_example_send_msg_r1.php | +문자보내기(여러명에게 동일한문자) | +
|---|---|
| php_example_send_msgs_r1.php | +문자보내기(여러명에게 다른문자) | +
| php_example_hstry_r1.php | +전송내역조회 | +
| php_example_hstry_detail_r1.php | +상세전송내역조회 | +
| php_example_select_price_r1.php | +발송가능건수 | +
+
-
-
-
-
diff --git a/src/main/webapp/publish/api_guide.html b/src/main/webapp/publish/api_guide.html
index a64963f9..0b084e01 100644
--- a/src/main/webapp/publish/api_guide.html
+++ b/src/main/webapp/publish/api_guide.html
@@ -38,7 +38,7 @@
-
-
-
+
+
+
+ IOS Example
-| 파일명 | -파일 설명 | -
|---|---|
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
| 파일명 | -파일 설명 | -
+
-
+
+
+
+
+
+ .NET Example
+| 파일명 | +파일 설명 | +
|---|---|
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
+
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+ AOS Example
+| 파일명 | +파일 설명 | +
|---|---|
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
+
+
+
+
+
+
+
+
+
+
+ IOS Example
+| 파일명 | +파일 설명 | +
|---|---|
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
+
+
+
+
-
+
-
-
+
- - 아래 예제(JSP)를 참고하시어 쉽고 편리하게 API를 연동할 수 있습니다. +
- - JSP 외 타 예제는 계속해서 업데이트 될 예정입니다. +
+
+
+
+
+ -
+
- + + +
- + + +
+
+
+
+
+
+
+
+
+
+ JSP Example
+| kakao jsp_example_send_msg_r1.jsp | +문자보내기(여러명에게 동일한문자) | +
|---|---|
| sp_example_send_msgs_r1.jsp | +문자보내기(여러명에게 다른문자) | +
| jsp_example_hstry_r1.jsp | +전송내역조회 | +
| jsp_example_hstry_detail_r1.jsp | +상세전송내역조회 | +
| jsp_example_select_price_r1.jsp | +발송가능건수 | +
+
+
+
+
+
+
+
+
+
+
+
+
+ ASP Example
+| 파일명 | +파일 설명 | +
|---|---|
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
+
+
+
+
+
+
+
+
+
+
+
+
+ PHP Example
+| php_example_send_msg_r1.php | +문자보내기(여러명에게 동일한문자) | +
|---|---|
| php_example_send_msgs_r1.php | +문자보내기(여러명에게 다른문자) | +
| php_example_hstry_r1.php | +전송내역조회 | +
| php_example_hstry_detail_r1.php | +상세전송내역조회 | +
| php_example_select_price_r1.php | +발송가능건수 | +
+
+
+
+
+
+
+
+
+
+
+
+
+ .NET Example
+| 파일명 | +파일 설명 | +
|---|---|
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
+
+
+
+
+
+
+
+
+
+
+
+
+ AOS Example
+| 파일명 | +파일 설명 | +
|---|---|
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
+
+
+
+
+
+
+
+
+
+
+ IOS Example
+| 파일명 | +파일 설명 | +
|---|---|
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
| 파일명 | +파일 설명 | +
+
+
+ 이용안내
채팅상담
-
+
-
+
@@ -186,1428 +181,3436 @@
-
-
-
+
+
-
-
+
API 사용안내
+REST API 개발 가이드
-
-
-
-
-
-
+
+
-
-
-
- - API를 통해서 동일한 내용의 문자를 대량으로 전송할 수 있습니다. -
- - 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용) -
- - 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다. -
+
+
- -
+
+
+
+
+
+
-
-
Request
-
-
-
Request
+
+
+
-
-
- -
+
- - API를 통해서 동일한 내용의 문자를 대량으로 전송할 수 있습니다. +
- - 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용) +
- - 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다. +
+
+
-
-
-
- Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
| Http Method | -POST | -||
|---|---|---|---|
| 프로토콜 | -HHTP/1.1 | -||
| HOST | -api.munjaon.co.kr | -||
| Service Port | -443 | -||
| 키 | +설명 | +타입 | +필수 | +
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
| callFrom | +발신자 번호(아이디에 등록되어 있는 번호) | +String | +O | +
| callToList | +수신자 번호(콤마(,) 기준으로 입력) | +String | +O | +
| smsTxt | +메시지 내용 | +String(1~2,000Byte) | +O | +
| nameStr | +메시지 내용에 [*이름*]이 있으면 치환용 이름 입력( | 로 구분 ) | +String | +X | +
| test_yn | +테스트 데이터 여부 | +String | +X | +
-
-
-
- | 키 | -설명 | -타입 | -필수 | -
|---|---|---|---|
| mberId | -사용자 ID | -String | -O | -
| accessKey | -인증용 API Key | -String | -O | -
| callFrom | -발신자 번호(아이디에 등록되어 있는 번호) | -String | -O | -
| callToList | -수신자 번호(콤마(,) 기준으로 입력) | -String | -O | -
| smsTxt | -메시지 내용 | -String(1~2,000Byte) | -O | -
| nameStr | -메시지 내용에 [*이름*]이 있으면 치환용 이름 입력( | 로 구분 ) | -String | -X | -
| test_yn | -테스트 데이터 여부 | -String | -X | -
-
- ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
-※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte
-
-
- [Example]
-
-
-
-
- ｛
-
-
- "mberId":"홍길동"
-,"accessKey":"XXXXXXXXXXXXXX414050694b953"
-,"callFrom":"01012341234"
-,"callToList":"01011111111,01022222222,01033333333"
-,"smsTxt":"문자 테스트~![*이름*]"
-,"nameStr":"홍길동1|홍길동2|홍길동3"
-,"test_yn":""
+
+
- ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte
｝
Response
-
-
-
-
- | 키 | -설명 | -타입 | -
|---|---|---|
| resultCode | -성공 여부("0" 아니면 실패) | -String | -
| data | -결과값 객체(성공 : 데이터, 실패 : 메시지) | -Object | -
| [data].msgGroupId | -메시지 그룹 ID | -String | -
| [data].msgType | -메시지 타입(4 : 단문, 5 : 장문) | -String | -
| [data].blockCnt | -수신거부 건수 | -String | -
| [data].failCnt | -전송 실패 건수 | -String | -
| [data].successCnt | -성공 건수 | -String | -
| [data].test_yn | -테스트 데이터 여부 | -String | -
-
- ※ JSON 객체로 응답합니다.
-
-
- [Example]O 성공 예시
-
-
- ｛
-
-
- "resultCode":"0"
-,"data"｛
-
-
- "msgGroupId":"MSGGID_0000000000000"
-,"msgType":"SMS"
-,"resultCode":"0"
-,"blockCnt":"0"
-,"failCnt":"0"
-,"successCnt":"3"
-,"test_yn":null
-｝
-｝
-
-
-
- [Example]X 실패 예시
-
-
- ｛
-
-
- "resultCode":"1040"
-,"data":"치환 데이터 오류"
-｝
-
-
-
-
- -
-
- - API를 통해서 다른 내용의 문자를 대량으로 전송할 수 있습니다. -
- - 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용) -
- - 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다. -
-
-
- Request
-
-
-
-
-
-
- Request
-| Http Method | -POST | -
|---|---|
| 프로토콜 | -HHTP/1.1 | -
| HOST | -api.munjaon.co.kr | -
| Service Port | -443 | -
-
-
-
- | 키 | -설명 | -타입 | -필수 | -
|---|---|---|---|
| mberId | -사용자 ID | -String | -O | -
| accessKey | -인증용 API Key | -String | -O | -
| callFrom | -발신자 번호(아이디에 등록되어 있는 번호) | -String | -O | -
| test_yn | -테스트 데이터 여부 | -String | -X | -
| callTo_1 | -수신자 번호 1 | -String | -O | -
| smsTxt_1 | -메시지 내용 1 | -String(1~2,000Byte) | -O | -
| ... | -... | -... | -... | -
| callTo_100 | -수신자 번호 100 | -String | -O | -
| smsTxt_100 | -메시지 내용 100 | -String(1~2,000Byte) | -O | -
-
- ※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte
-
-
-
-
- [Example]
-
-
- ｛
-
-
- "mberId":"홍길동"
-,"accessKey":"XXXXXXXXXXXXXX414050694b953"
-,"callFrom":"01012341234"
-,"test_yn":""
-,"callTo_1":"01011111111"
-,"smsTxt_1":"문자 테스트 1"
-,"callTo_2":"01022222222"
-,"smsTxt_2":"문자 테스트 2"
-｝
-Response
-
-
-
-
- | 키 | -설명 | -타입 | -
|---|---|---|
| resultCode | -성공 여부("0" 아니면 실패) | -String | -
| data | -결과값 객체(성공 : 데이터, 실패 : 메시지) | -Object | -
| [data].msgGroupIdList | -메시지 그룹 ID 리스트 | -List String | -
| [data].msgType | -메시지 타입(4 : 단문, 5 : 장문) | -String | -
| [data].blockCnt | -수신거부 건수 | -String | -
| [data].failCnt | -전송 실패 건수 | -String | -
| [data].successCnt | -성공 건수 | -String | -
| [data].test_yn | -테스트 데이터 여부 | -String | -
-
- ※ JSON 객체로 응답합니다.
-
-
- [Example]O 성공 예시
-
-
- ｛
-
-
- "resultCode":"0"
-,"data":［
-
-
- "msgGroupIdList":［
-｛
-"MSGGID_0000000013451"
-｝
-,｛
-"MSGGID_0000000013452"
-｝
-］
-,"msgTypeList":［
-｛
-"SMS"
-｝
-,｛
-"SMS"
-｝
-］
-,"resultCode":"0"
-,"successCnt":"2"
-,"failCnt":"0"
-,"blockCnt":"0"
-,"test_yn":null
-］
-｝
-
-
-
- [Example]X 실패 예시
-
-
- ｛
-
-
- "resultCode":"1040"
-,"data":"치환 데이터 오류"
-｝
-
-
-
-
- - 문자온 사이트 및 API를 통해 전송된 문자 발송내역을 조회할 수 있습니다. -
- - 문자 발송내역은 날짜별로 조회되며, 최근 3개월까지만 조회 가능합니다. -
- - 발신번호별 문자 발송내역 조회 기능은 제공되지 않습니다. -
-
-
Request
-
-
-
-
-
-
- Request
-| Http Method | -POST | -
|---|---|
| 프로토콜 | -HHTP/1.1 | -
| HOST | -api.munjaon.co.kr | -
| Service Port | -443 | -
-
-
-
- | 키 | -설명 | -타입 | -필수 | -
|---|---|---|---|
| mberId | -사용자 ID | -String | -O | -
| accessKey | -인증용 API Key | -String | -O | -
| page | -페이지 번호 | -String | -X | -
| pageSize | -페이지당 출력 개수 | -String | -X | -
| startDate | -시작 일자 | -String | -X | -
| endDate | -마감 일자 | -String | -X | -
| test_yn | -테스트 데이터 여부 | -String | -X | -
-
- ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
-
-
-
-
- [Example]
-
-
- ｛
-
-
- "mberId":"홍길동"
-,"accessKey":"XXXXXXXXXXXXXX414050694b953"
-,"page":""
-,"pageSize":""
-,"startDate":""
-,"endDate":""
-,"test_yn":""
-｝
-Response
-
-
-
-
- | 키 | -설명 | -타입 | -
|---|---|---|
| resultCode | -성공 여부("0" 아니면 실패) | -String | -
| data | -결과값 객체(성공 : 데이터, 실패 : 메시지) | -Object | -
| [data].message | -문자 | -String | -
| [data].next_yn | -다음 페이지 여부 | -String | -
| [data].objectList | -결과값 목록 | -Object List | -
| [data].msgGroupId | -메시지 그룹 ID | -String | -
| [data].msgId | -메시지 ID | -String | -
| [data].msgTypeName | -문자 구분명(단문, 장문, 그림) | -String | -
| [data].msgType | -메시지 타입(4 : 단문, 5 : 장문) | -String | -
| [data].callFrom | -발신자 번호 | -String | -
| [data].callTo | -수신자 번호 | -String | -
| [data].msgGroupCnt | -문자 발송 건수 | -String | -
| [data].sCnt | -성공 건수 | -String | -
| [data].fCnt | -실패 건수 | -String | -
| [data].wCnt | -대기 건수 | -String | -
| [data].msgResult | -발송 결과(성공 : S, 실패 : F) | -String | -
| [data].smsTxt | -문자 내용 | -String | -
| [data].subject | -제목 | -String | -
| [data].reqdate | -발송 일자 | -String | -
| [data].curState | -전송 처리 결과값 | -String | -
| [data].userId | -사용자 ID | -String | -
| [data].regdate | -등록 일자 | -String | -
| [data].reserveCYn | -예약 취소 여부 | -String | -
| [data].ttlCnt | -전체 요청 수 | -String | -
| [data].remainMsgCnt | -남은 문자 건수 | -String | -
| [data].totMsgCnt | -전체 문자 개수 | -String | -
-
- ※ JSON 객체로 응답합니다.
-
-
[Example]O 성공 예시
-
-
｛
-
-
"resultCode":"0"
-,"data":［
+
+
+
+
+
- [Example]
+ ｛
-
+
+
+
+ "mberId":"홍길동"
+,"accessKey":"XXXXXXXXXXXXXX414050694b953"
+,"callFrom":"01012341234"
+,"callToList":"01011111111,01022222222,01033333333"
+,"smsTxt":"문자 테스트~![*이름*]"
+,"nameStr":"홍길동1|홍길동2|홍길동3"
+,"test_yn":""
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].msgGroupId | +메시지 그룹 ID | +String | +
| [data].msgType | +메시지 타입(4 : 단문, 5 : 장문) | +String | +
| [data].blockCnt | +수신거부 건수 | +String | +
| [data].failCnt | +전송 실패 건수 | +String | +
| [data].successCnt | +성공 건수 | +String | +
| [data].test_yn | +테스트 데이터 여부 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
- [Example]O 성공 예시
+
+
+
- ｛
+"resultCode":"0"
-,"message": null
-,"next_yn":"n"
-,"msgGroupId":"MSGGID_0000000000000"
-,"objectList":［
-｛
-
-
- "msgTypeName":"단문(SMS)"
-,"msgType":"4"
-,"callFrom":"01011112222"
-,"callTo":"01011112223"
-,"msgGroupCnt":"2"
-,"msgGroupId":"MSGGID_0000000013340"
-,"msgId":"MSGID_0000000000001"
-,"scnt":"2"
-,"fcnt":"0"
-,"wcnt":"0"
-,"msgResult":"S"
-,"smsTxt":"문자 내용 단문 예제"
-,"subject":null
-,"reqdate":"2023-06-13 17:48:07"
-,"curState":"3"
-,"userId":"testuser"
-,"regdate":"2023-06-13 17:48:07"
-,"reserveCYn":"N"
-,"ttlCnt":"1"
-,"remainMsgCnt":"40"
-,"totMsgCnt":"70"
+,"data"｛
+
+
"msgGroupId":"MSGGID_0000000000000"
+,"msgType":"SMS"
+,"resultCode":"0"
+,"blockCnt":"0"
+,"failCnt":"0"
+,"successCnt":"3"
+,"test_yn":null
｝
-,｛
-
-
- "msgTypeName":"장문(LMS)"
-,"msgType":"6"
-,"callFrom":"01011112222"
-,"callTo":"01011112223"
-,"msgGroupCnt":"1"
-,"msgGroupId":"MSGGID_0000000013341"
-,"msgId":"MSGID_0000000000002"
-,"scnt":"1"
-,"fcnt":"0"
-,"wcnt":"0"
-,"msgResult":"S"
-,"smsTxt":"문자 내용 장문 예제"
-,subject":null
-,reqdate":"2023-06-02 11:46:50"
-,"curState":"3"
-,"userId":"testuser"
-,"regdate":"2023-06-02 11:46:49"
-,"reserveCYn":"N"
-,"ttlCnt":"1"
-,"remainMsgCnt":"40"
-,"totMsgCnt":"70"
-｝
-］
-｝
-］
+｝
｝
-
-
-
- [Example]X 실패 예시
-
-
- ｛
-
-
-
- "resultCode":"3099"
-,"data":"기타 시스템 오류"
+
+
+
[Example]X 실패 예시
+
+
- ｛
+
+
+ "resultCode":"1040"
+,"data":"치환 데이터 오류"
+｝
｝
-
-
-
- - 전송결과 조회의 "msgGroupId"를 사용하여 전송된 문자의 상세결과를 수신번호별로 조회할 수 있습니다. -
- - 전송결과가 "대기"인 경우에는 최종 결과 확인까지 최대 72시간까지 소요됩니다. -
-
-
Request
-
-
-
+ Request
+
+
+
-
+
- - API를 통해서 다른 내용의 문자를 대량으로 전송할 수 있습니다. +
- - 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용) +
- - 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다. +
+
+
-
-
-
- Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
| Http Method | -POST | -||
|---|---|---|---|
| 프로토콜 | -HHTP/1.1 | -||
| HOST | -api.munjaon.co.kr | -||
| Service Port | -443 | -||
| 키 | +설명 | +타입 | +필수 | +
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
| callFrom | +발신자 번호(아이디에 등록되어 있는 번호) | +String | +O | +
| test_yn | +테스트 데이터 여부 | +String | +X | +
| callTo_1 | +수신자 번호 1 | +String | +O | +
| smsTxt_1 | +메시지 내용 1 | +String(1~2,000Byte) | +O | +
| ... | +... | +... | +... | +
| callTo_100 | +수신자 번호 100 | +String | +O | +
| smsTxt_100 | +메시지 내용 100 | +String(1~2,000Byte) | +O | +
-
-
-
- | 키 | -설명 | -타입 | -필수 | -
|---|---|---|---|
| mberId | -사용자 ID | -String | -O | -
| accessKey | -인증용 API Key | -String | -O | -
| msgGroupId | -메시지 그룹 ID | -String | -O | -
| page | -페이지 번호 | -String | -X | -
| pageSize | -페이지당 출력 개수 | -String | -X | -
| test_yn | -테스트 데이터 여부 | -String | -X | -
-
- ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
-
-
[Example]
-
-
-
-
- ｛
-
-
- "mberId":"홍길동"
-,"accessKey":"XXXXXXXXXXXXXX414050694b953"
-,"msgGroupId":"MSGGID_0000000011452"
-,"page":""
-,"pageSize":""
-,"test_yn":""
+
+
- ※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte
｝
Response
-
-
-
-
- | 키 | -설명 | -타입 | -
|---|---|---|
| resultCode | -성공 여부("0" 아니면 실패) | -String | -
| data | -결과값 객체(성공 : 데이터, 실패 : 메시지) | -Object | -
| [data].message | -문자 | -String | -
| [data].next_yn | -다음 페이지 여부 | -String | -
| [data].objectList | -결과값 목록 | -Object List | -
| [data].msgGroupId | -메시지 그룹 ID | -String | -
| [data].msgId | -메시지 ID | -String | -
| [data].msgTypeName | -문자 구분명(단문, 장문, 그림) | -String | -
| [data].msgType | -메시지 타입(4 : 단문, 5 : 장문) | -String | -
| [data].callFrom | -발신자 번호 | -String | -
| [data].callTo | -수신자 번호 | -String | -
| [data].msgGroupCnt | -문자 발송 건수 | -String | -
| [data].sCnt | -성공 건수 | -String | -
| [data].fCnt | -실패 건수 | -String | -
| [data].wCnt | -대기 건수 | -String | -
| [data].msgResult | -발송 결과(성공 : S, 실패 : F) | -String | -
| [data].smsTxt | -문자 내용 | -String | -
| [data].subject | -제목 | -String | -
| [data].reqdate | -발송 일자 | -String | -
| [data].curState | -전송 처리 결과값 | -String | -
| [data].userId | -사용자 ID | -String | -
| [data].regdate | -등록 일자 | -String | -
| [data].reserveCYn | -예약 취소 여부 | -String | -
| [data].ttlCnt | -전체 요청 수 | -String | -
| [data].remainMsgCnt | -남은 문자 건수 | -String | -
| [data].totMsgCnt | -전체 문자 개수 | -String | -
-
- ※ JSON 객체로 응답합니다.
-
-
[Example]O 성공 예시
-
-
｛
-
-
+ "resultCode":"0"
-,"data":［
+
+
+
+
+
+
+ [Example]
+ ｛
-
+
+
+
+ "mberId":"홍길동"
+,"accessKey":"XXXXXXXXXXXXXX414050694b953"
+,"callFrom":"01012341234"
+,"test_yn":""
+,"callTo_1":"01011111111"
+,"smsTxt_1":"문자 테스트 1"
+,"callTo_2":"01022222222"
+,"smsTxt_2":"문자 테스트 2"
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].msgGroupIdList | +메시지 그룹 ID 리스트 | +List String | +
| [data].msgType | +메시지 타입(4 : 단문, 5 : 장문) | +String | +
| [data].blockCnt | +수신거부 건수 | +String | +
| [data].failCnt | +전송 실패 건수 | +String | +
| [data].successCnt | +성공 건수 | +String | +
| [data].test_yn | +테스트 데이터 여부 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
+ [Example]O 성공 예시
+
+
+
+ ｛
+"resultCode":"0"
-,"message": null
-,"next_yn":"n"
-,"msgGroupId":"MSGGID_0000000000000"
-,"objectList":［
+,"data":［
+
+
+ "msgGroupIdList":［
+｛
+"MSGGID_0000000013451"
+｝
+,｛
+"MSGGID_0000000013452"
+｝
+］
+,"msgTypeList":［
+｛
+"SMS"
+｝
+,｛
+"SMS"
+｝
+］
+,"resultCode":"0"
+,"successCnt":"2"
+,"failCnt":"0"
+,"blockCnt":"0"
+,"test_yn":null
+］
+｝
+
+
+
+ [Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"1040"
+,"data":"치환 데이터 오류"
+｝
+
+
+
-
-
- -
+
- - 문자온 사이트 및 API를 통해 전송된 문자 발송내역을 조회할 수 있습니다. +
- - 문자 발송내역은 날짜별로 조회되며, 최근 3개월까지만 조회 가능합니다. +
- - 발신번호별 문자 발송내역 조회 기능은 제공되지 않습니다. +
+
+
+ Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
+
+
+
+ | 키 | +설명 | +타입 | +필수 | +
|---|---|---|---|
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
| page | +페이지 번호 | +String | +X | +
| pageSize | +페이지당 출력 개수 | +String | +X | +
| startDate | +시작 일자 | +String | +X | +
| endDate | +마감 일자 | +String | +X | +
| test_yn | +테스트 데이터 여부 | +String | +X | +
+
+ ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+
+
+
+
+ [Example]
+
+
+ ｛
+
+
+ "mberId":"홍길동"
+,"accessKey":"XXXXXXXXXXXXXX414050694b953"
+,"page":""
+,"pageSize":""
+,"startDate":""
+,"endDate":""
+,"test_yn":""
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].message | +문자 | +String | +
| [data].next_yn | +다음 페이지 여부 | +String | +
| [data].objectList | +결과값 목록 | +Object List | +
| [data].msgGroupId | +메시지 그룹 ID | +String | +
| [data].msgId | +메시지 ID | +String | +
| [data].msgTypeName | +문자 구분명(단문, 장문, 그림) | +String | +
| [data].msgType | +메시지 타입(4 : 단문, 5 : 장문) | +String | +
| [data].callFrom | +발신자 번호 | +String | +
| [data].callTo | +수신자 번호 | +String | +
| [data].msgGroupCnt | +문자 발송 건수 | +String | +
| [data].sCnt | +성공 건수 | +String | +
| [data].fCnt | +실패 건수 | +String | +
| [data].wCnt | +대기 건수 | +String | +
| [data].msgResult | +발송 결과(성공 : S, 실패 : F) | +String | +
| [data].smsTxt | +문자 내용 | +String | +
| [data].subject | +제목 | +String | +
| [data].reqdate | +발송 일자 | +String | +
| [data].curState | +전송 처리 결과값 | +String | +
| [data].userId | +사용자 ID | +String | +
| [data].regdate | +등록 일자 | +String | +
| [data].reserveCYn | +예약 취소 여부 | +String | +
| [data].ttlCnt | +전체 요청 수 | +String | +
| [data].remainMsgCnt | +남은 문자 건수 | +String | +
| [data].totMsgCnt | +전체 문자 개수 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
+
+ [Example]O 성공 예시
+
+
+ ｛
+
+
+ "resultCode":"0"
+,"data":［
｛
-
-
+ "msgTypeName":"단문(SMS)"
-,"msgType":"4"
-,"callFrom":"01011112222"
-,"callTo":"01011112223"
-,"msgGroupCnt":"2"
-,"msgGroupId":"MSGGID_0000000013340"
-,"msgId":"MSGID_0000000000001"
-,"scnt":null
-,"fcnt":null
-,"wcnt":null
-,"msgResult":"S"
-,"smsTxt":"문자 내용 단문 예제"
-,"subject":null
-,"reqdate":"2023-06-13 17:48:08"
-,"curState":"3"
-,"userId":"testuser"
-,"regdate":"2023-06-13 17:48:07"
-,"reserveCYn":"N"
-,"ttlCnt":"10"
-,"remainMsgCnt":"0"
-,"totMsgCnt":"10"
+
+
+ "resultCode":"0"
+,"message": null
+,"next_yn":"n"
+,"msgGroupId":"MSGGID_0000000000000"
+,"objectList":［
+｛
+
+
+ "msgTypeName":"단문(SMS)"
+,"msgType":"4"
+,"callFrom":"01011112222"
+,"callTo":"01011112223"
+,"msgGroupCnt":"2"
+,"msgGroupId":"MSGGID_0000000013340"
+,"msgId":"MSGID_0000000000001"
+,"scnt":"2"
+,"fcnt":"0"
+,"wcnt":"0"
+,"msgResult":"S"
+,"smsTxt":"문자 내용 단문 예제"
+,"subject":null
+,"reqdate":"2023-06-13 17:48:07"
+,"curState":"3"
+,"userId":"testuser"
+,"regdate":"2023-06-13 17:48:07"
+,"reserveCYn":"N"
+,"ttlCnt":"1"
+,"remainMsgCnt":"40"
+,"totMsgCnt":"70"
+｝
+,｛
+
+
+ "msgTypeName":"장문(LMS)"
+,"msgType":"6"
+,"callFrom":"01011112222"
+,"callTo":"01011112223"
+,"msgGroupCnt":"1"
+,"msgGroupId":"MSGGID_0000000013341"
+,"msgId":"MSGID_0000000000002"
+,"scnt":"1"
+,"fcnt":"0"
+,"wcnt":"0"
+,"msgResult":"S"
+,"smsTxt":"문자 내용 장문 예제"
+,subject":null
+,reqdate":"2023-06-02 11:46:50"
+,"curState":"3"
+,"userId":"testuser"
+,"regdate":"2023-06-02 11:46:49"
+,"reserveCYn":"N"
+,"ttlCnt":"1"
+,"remainMsgCnt":"40"
+,"totMsgCnt":"70"
+｝
+］
+｝
+］
+｝
+
+
+
+ [Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"3099"
+,"data":"기타 시스템 오류"
+｝
+
+
+
+ -
+
- - 전송결과 조회의 "msgGroupId"를 사용하여 전송된 문자의 상세결과를 수신번호별로 조회할 수 있습니다. +
- - 전송결과가 "대기"인 경우에는 최종 결과 확인까지 최대 72시간까지 소요됩니다. +
+
+
+
+ Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
+
+
+
+ | 키 | +설명 | +타입 | +필수 | +
|---|---|---|---|
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
| msgGroupId | +메시지 그룹 ID | +String | +O | +
| page | +페이지 번호 | +String | +X | +
| pageSize | +페이지당 출력 개수 | +String | +X | +
| test_yn | +테스트 데이터 여부 | +String | +X | +
+
+ ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+
+
+
+
+ [Example]
+
+
+ ｛
+
+
+ "mberId":"홍길동"
+,"accessKey":"XXXXXXXXXXXXXX414050694b953"
+,"msgGroupId":"MSGGID_0000000011452"
+,"page":""
+,"pageSize":""
+,"test_yn":""
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].message | +문자 | +String | +
| [data].next_yn | +다음 페이지 여부 | +String | +
| [data].objectList | +결과값 목록 | +Object List | +
| [data].msgGroupId | +메시지 그룹 ID | +String | +
| [data].msgId | +메시지 ID | +String | +
| [data].msgTypeName | +문자 구분명(단문, 장문, 그림) | +String | +
| [data].msgType | +메시지 타입(4 : 단문, 5 : 장문) | +String | +
| [data].callFrom | +발신자 번호 | +String | +
| [data].callTo | +수신자 번호 | +String | +
| [data].msgGroupCnt | +문자 발송 건수 | +String | +
| [data].sCnt | +성공 건수 | +String | +
| [data].fCnt | +실패 건수 | +String | +
| [data].wCnt | +대기 건수 | +String | +
| [data].msgResult | +발송 결과(성공 : S, 실패 : F) | +String | +
| [data].smsTxt | +문자 내용 | +String | +
| [data].subject | +제목 | +String | +
| [data].reqdate | +발송 일자 | +String | +
| [data].curState | +전송 처리 결과값 | +String | +
| [data].userId | +사용자 ID | +String | +
| [data].regdate | +등록 일자 | +String | +
| [data].reserveCYn | +예약 취소 여부 | +String | +
| [data].ttlCnt | +전체 요청 수 | +String | +
| [data].remainMsgCnt | +남은 문자 건수 | +String | +
| [data].totMsgCnt | +전체 문자 개수 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
+ [Example]O 성공 예시
+
+
+ ｛
+
+
+ "resultCode":"0"
+,"data":［
+｛
+
+
+ "resultCode":"0"
+,"message": null
+,"next_yn":"n"
+,"msgGroupId":"MSGGID_0000000000000"
+,"objectList":［
+｛
+
+
+ "msgTypeName":"단문(SMS)"
+,"msgType":"4"
+,"callFrom":"01011112222"
+,"callTo":"01011112223"
+,"msgGroupCnt":"2"
+,"msgGroupId":"MSGGID_0000000013340"
+,"msgId":"MSGID_0000000000001"
+,"scnt":null
+,"fcnt":null
+,"wcnt":null
+,"msgResult":"S"
+,"smsTxt":"문자 내용 단문 예제"
+,"subject":null
+,"reqdate":"2023-06-13 17:48:08"
+,"curState":"3"
+,"userId":"testuser"
+,"regdate":"2023-06-13 17:48:07"
+,"reserveCYn":"N"
+,"ttlCnt":"10"
+,"remainMsgCnt":"0"
+,"totMsgCnt":"10"
+｝
+,｛
+
+
+ "msgTypeName":"단문(SMS)"
+,"msgType":"4"
+,"callFrom":"01011112222"
+,"callTo":"01011112223"
+,"msgGroupCnt":"2"
+,"msgGroupId":"MSGGID_0000000013340"
+,"msgId":"MSGID_0000000000002"
+,"scnt":null
+,"fcnt":null
+,"wcnt":null
+,"msgResult":"S"
+,"smsTxt":"문자 내용 단문 예제"
+,subject":null
+,reqdate":"2023-06-13 17:48:09"
+,"curState":"3"
+,"userId":"testuser"
+,"regdate":"2023-06-13 17:48:07"
+,"reserveCYn":"N"
+,"ttlCnt":"10"
+,"remainMsgCnt":"0"
+,"totMsgCnt":"10"
+｝
+］
+｝
+］
+｝
+
+
+
+ [Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"4099"
+,"data":"기타 시스템 오류"
+｝
+
+
+
- -
+
- - 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다. +
- - 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다. +
+
+
- Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
+
+
+
+ | 키 | +설명 | +타입 | +필수 | +
|---|---|---|---|
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
+
+ ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+
+
+
+
+ [Example]
+
+
+ ｛
+
+
+ "mberId":"String"
+,"accessKey":"String"
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].longPrice | +장문 단가 | +String | +
| [data].longSendPsbltEa | +장문 발송 가능 건수 | +String | +
| [data].mberMoney | +현재 보유 금액 | +String | +
| [data].message | +문자 | +String | +
| [data].picturePrice | +그림문자 단가 | +String | +
| [data].pictureSendPsbltEa | +그림문자 발송 가능 건수 | +String | +
| [data].shortPrice | +단문 단가 | +String | +
| [data].shortSendPsbltEa | +단문 발송 가능 건수 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
- [Example]O 성공 예시
+
+
+ ｛
+
+
- "resultCode":"0"
+,"data"｛
+
+
"longPrice":"50"
+,"longSendPsbltEa":"19651"
+,"mberMoney":"982586.7"
+,"message":null
+,"picturePrice":"90"
+,"pictureSendPsbltEa":"10917"
+,"shortPrice":"18"
+,"shortSendPsbltEa":"54588"
｝
-,｛
-
-
- "msgTypeName":"단문(SMS)"
-,"msgType":"4"
-,"callFrom":"01011112222"
-,"callTo":"01011112223"
-,"msgGroupCnt":"2"
-,"msgGroupId":"MSGGID_0000000013340"
-,"msgId":"MSGID_0000000000002"
-,"scnt":null
-,"fcnt":null
-,"wcnt":null
-,"msgResult":"S"
-,"smsTxt":"문자 내용 단문 예제"
-,subject":null
-,reqdate":"2023-06-13 17:48:09"
-,"curState":"3"
-,"userId":"testuser"
-,"regdate":"2023-06-13 17:48:07"
-,"reserveCYn":"N"
-,"ttlCnt":"10"
-,"remainMsgCnt":"0"
-,"totMsgCnt":"10"
-｝
-］
-｝
-］
+｝
｝
-
[Example]X 실패 예시
-
-
+ ｛
-
-
-
- "resultCode":"4099"
-,"data":"기타 시스템 오류"
+
+
+
[Example]X 실패 예시
+
+
- ｛
+
+
+ "resultCode":"5099"
+,"data":"기타 시스템 오류"
+｝
｝
-
-
-
- - 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다. -
- - 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다. -
-
-
Request
-
-
-
-
-
+
+
Request
+ +
+
+
+
+
+ -
+
+
+
+
+
+
+
+
+
+
+
-
+
- - API를 통해서 동일한 내용의 문자를 대량으로 전송할 수 있습니다. +
- - 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용) +
- - 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다. +
+
+
-
-
-
- Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
| Http Method | -POST | -||
|---|---|---|---|
| 프로토콜 | -HHTP/1.1 | -||
| HOST | -api.munjaon.co.kr | -||
| Service Port | -443 | -||
| 키 | +설명 | +타입 | +필수 | +
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
| callFrom | +발신자 번호(아이디에 등록되어 있는 번호) | +String | +O | +
| callToList | +수신자 번호(콤마(,) 기준으로 입력) | +String | +O | +
| smsTxt | +메시지 내용 | +String(1~2,000Byte) | +O | +
| nameStr | +메시지 내용에 [*이름*]이 있으면 치환용 이름 입력( | 로 구분 ) | +String | +X | +
| test_yn | +테스트 데이터 여부 | +String | +X | +
-
-
-
- | 키 | -설명 | -타입 | -필수 | -
|---|---|---|---|
| mberId | -사용자 ID | -String | -O | -
| accessKey | -인증용 API Key | -String | -O | -
-
- ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
-
-
[Example]
-
-
-
-
- ｛
-
-
- "mberId":"String"
-,"accessKey":"String"
+
+
- ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte
｝
Response
-
-
-
-
- | 키 | -설명 | -타입 | -
|---|---|---|
| resultCode | -성공 여부("0" 아니면 실패) | -String | -
| data | -결과값 객체(성공 : 데이터, 실패 : 메시지) | -Object | -
| [data].longPrice | -장문 단가 | -String | -
| [data].longSendPsbltEa | -장문 발송 가능 건수 | -String | -
| [data].mberMoney | -현재 보유 금액 | -String | -
| [data].message | -문자 | -String | -
| [data].picturePrice | -그림문자 단가 | -String | -
| [data].pictureSendPsbltEa | -그림문자 발송 가능 건수 | -String | -
| [data].shortPrice | -단문 단가 | -String | -
| [data].shortSendPsbltEa | -단문 발송 가능 건수 | -String | -
-
- ※ JSON 객체로 응답합니다.
-
-
+ [Example]O 성공 예시
-
-
- ｛
-
-
-
-
+
+
+
+
"resultCode":"0"
-,"data"｛
-
-
- "longPrice":"50"
-,"longSendPsbltEa":"19651"
-,"mberMoney":"982586.7"
-,"message":null
-,"picturePrice":"90"
-,"pictureSendPsbltEa":"10917"
-,"shortPrice":"18"
-,"shortSendPsbltEa":"54588"
+
+
- [Example]
+
+
- ｛
+
+
- "mberId":"홍길동"
+,"accessKey":"XXXXXXXXXXXXXX414050694b953"
+,"callFrom":"01012341234"
+,"callToList":"01011111111,01022222222,01033333333"
+,"smsTxt":"문자 테스트~![*이름*]"
+,"nameStr":"홍길동1|홍길동2|홍길동3"
+,"test_yn":""
｝
+｝
｝
-
+ [Example]X 실패 예시
-
-
+
+ ｛
-
-
-
- "resultCode":"5099"
-,"data":"기타 시스템 오류"
+ + +Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].msgGroupId | +메시지 그룹 ID | +String | +
| [data].msgType | +메시지 타입(4 : 단문, 5 : 장문) | +String | +
| [data].blockCnt | +수신거부 건수 | +String | +
| [data].failCnt | +전송 실패 건수 | +String | +
| [data].successCnt | +성공 건수 | +String | +
| [data].test_yn | +테스트 데이터 여부 | +String | +
+
- ※ JSON 객체로 응답합니다.
｝
+
+ [Example]O 성공 예시
+
+
+ ｛
+
+
+ "resultCode":"0"
+,"data"｛
+
+
+ "msgGroupId":"MSGGID_0000000000000"
+,"msgType":"SMS"
+,"resultCode":"0"
+,"blockCnt":"0"
+,"failCnt":"0"
+,"successCnt":"3"
+,"test_yn":null
+｝
+｝
+
+
+
[Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"1040"
+,"data":"치환 데이터 오류"
+｝
+
+
+
+ -
+
- - API를 통해서 다른 내용의 문자를 대량으로 전송할 수 있습니다. +
- - 발신번호는 문자온 사이트를 통해 사전등록 후 이용하실 수 있습니다.(마이페이지-발신번호 관리 메뉴 이용) +
- - 문자 내용이 "90byte"를 초과하는 경우 장문(LMS)으로 자동 전환됩니다. +
+
+
+
+ Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
+
+
+
+ | 키 | +설명 | +타입 | +필수 | +
|---|---|---|---|
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
| callFrom | +발신자 번호(아이디에 등록되어 있는 번호) | +String | +O | +
| test_yn | +테스트 데이터 여부 | +String | +X | +
| callTo_1 | +수신자 번호 1 | +String | +O | +
| smsTxt_1 | +메시지 내용 1 | +String(1~2,000Byte) | +O | +
| ... | +... | +... | +... | +
| callTo_100 | +수신자 번호 100 | +String | +O | +
| smsTxt_100 | +메시지 내용 100 | +String(1~2,000Byte) | +O | +
+
+ ※ 문자 텍스트 용량(byte) : 한글 1자당 2byte, 영문/숫자 1자당 1byte
+
+
+
+
+ [Example]
+
+
+ ｛
+
+
+ "mberId":"홍길동"
+,"accessKey":"XXXXXXXXXXXXXX414050694b953"
+,"callFrom":"01012341234"
+,"test_yn":""
+,"callTo_1":"01011111111"
+,"smsTxt_1":"문자 테스트 1"
+,"callTo_2":"01022222222"
+,"smsTxt_2":"문자 테스트 2"
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].msgGroupIdList | +메시지 그룹 ID 리스트 | +List String | +
| [data].msgType | +메시지 타입(4 : 단문, 5 : 장문) | +String | +
| [data].blockCnt | +수신거부 건수 | +String | +
| [data].failCnt | +전송 실패 건수 | +String | +
| [data].successCnt | +성공 건수 | +String | +
| [data].test_yn | +테스트 데이터 여부 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
+ [Example]O 성공 예시
+
+
+ ｛
+
+
+ "resultCode":"0"
+,"data":［
+
+
+ "msgGroupIdList":［
+｛
+"MSGGID_0000000013451"
+｝
+,｛
+"MSGGID_0000000013452"
+｝
+］
+,"msgTypeList":［
+｛
+"SMS"
+｝
+,｛
+"SMS"
+｝
+］
+,"resultCode":"0"
+,"successCnt":"2"
+,"failCnt":"0"
+,"blockCnt":"0"
+,"test_yn":null
+］
+｝
+
+
+
+ [Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"1040"
+,"data":"치환 데이터 오류"
+｝
+
+
+
+ -
+
- - 문자온 사이트 및 API를 통해 전송된 문자 발송내역을 조회할 수 있습니다. +
- - 문자 발송내역은 날짜별로 조회되며, 최근 3개월까지만 조회 가능합니다. +
- - 발신번호별 문자 발송내역 조회 기능은 제공되지 않습니다. +
+
+
+
+ Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
+
+
+
+ | 키 | +설명 | +타입 | +필수 | +
|---|---|---|---|
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
| page | +페이지 번호 | +String | +X | +
| pageSize | +페이지당 출력 개수 | +String | +X | +
| startDate | +시작 일자 | +String | +X | +
| endDate | +마감 일자 | +String | +X | +
| test_yn | +테스트 데이터 여부 | +String | +X | +
+
+ ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+
+
+
+
+ [Example]
+
+
+ ｛
+
+
+ "mberId":"홍길동"
+,"accessKey":"XXXXXXXXXXXXXX414050694b953"
+,"page":""
+,"pageSize":""
+,"startDate":""
+,"endDate":""
+,"test_yn":""
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].message | +문자 | +String | +
| [data].next_yn | +다음 페이지 여부 | +String | +
| [data].objectList | +결과값 목록 | +Object List | +
| [data].msgGroupId | +메시지 그룹 ID | +String | +
| [data].msgId | +메시지 ID | +String | +
| [data].msgTypeName | +문자 구분명(단문, 장문, 그림) | +String | +
| [data].msgType | +메시지 타입(4 : 단문, 5 : 장문) | +String | +
| [data].callFrom | +발신자 번호 | +String | +
| [data].callTo | +수신자 번호 | +String | +
| [data].msgGroupCnt | +문자 발송 건수 | +String | +
| [data].sCnt | +성공 건수 | +String | +
| [data].fCnt | +실패 건수 | +String | +
| [data].wCnt | +대기 건수 | +String | +
| [data].msgResult | +발송 결과(성공 : S, 실패 : F) | +String | +
| [data].smsTxt | +문자 내용 | +String | +
| [data].subject | +제목 | +String | +
| [data].reqdate | +발송 일자 | +String | +
| [data].curState | +전송 처리 결과값 | +String | +
| [data].userId | +사용자 ID | +String | +
| [data].regdate | +등록 일자 | +String | +
| [data].reserveCYn | +예약 취소 여부 | +String | +
| [data].ttlCnt | +전체 요청 수 | +String | +
| [data].remainMsgCnt | +남은 문자 건수 | +String | +
| [data].totMsgCnt | +전체 문자 개수 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
+ [Example]O 성공 예시
+
+
+ ｛
+
+
+ "resultCode":"0"
+,"data":［
+｛
+
+
+ "resultCode":"0"
+,"message": null
+,"next_yn":"n"
+,"msgGroupId":"MSGGID_0000000000000"
+,"objectList":［
+｛
+
+
+ "msgTypeName":"단문(SMS)"
+,"msgType":"4"
+,"callFrom":"01011112222"
+,"callTo":"01011112223"
+,"msgGroupCnt":"2"
+,"msgGroupId":"MSGGID_0000000013340"
+,"msgId":"MSGID_0000000000001"
+,"scnt":"2"
+,"fcnt":"0"
+,"wcnt":"0"
+,"msgResult":"S"
+,"smsTxt":"문자 내용 단문 예제"
+,"subject":null
+,"reqdate":"2023-06-13 17:48:07"
+,"curState":"3"
+,"userId":"testuser"
+,"regdate":"2023-06-13 17:48:07"
+,"reserveCYn":"N"
+,"ttlCnt":"1"
+,"remainMsgCnt":"40"
+,"totMsgCnt":"70"
+｝
+,｛
+
+
+ "msgTypeName":"장문(LMS)"
+,"msgType":"6"
+,"callFrom":"01011112222"
+,"callTo":"01011112223"
+,"msgGroupCnt":"1"
+,"msgGroupId":"MSGGID_0000000013341"
+,"msgId":"MSGID_0000000000002"
+,"scnt":"1"
+,"fcnt":"0"
+,"wcnt":"0"
+,"msgResult":"S"
+,"smsTxt":"문자 내용 장문 예제"
+,subject":null
+,reqdate":"2023-06-02 11:46:50"
+,"curState":"3"
+,"userId":"testuser"
+,"regdate":"2023-06-02 11:46:49"
+,"reserveCYn":"N"
+,"ttlCnt":"1"
+,"remainMsgCnt":"40"
+,"totMsgCnt":"70"
+｝
+］
+｝
+］
+｝
+
+
+
+ [Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"3099"
+,"data":"기타 시스템 오류"
+｝
+
+
+
+ -
+
- - 전송결과 조회의 "msgGroupId"를 사용하여 전송된 문자의 상세결과를 수신번호별로 조회할 수 있습니다. +
- - 전송결과가 "대기"인 경우에는 최종 결과 확인까지 최대 72시간까지 소요됩니다. +
+
+
+
+ Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
+
+
+
+ | 키 | +설명 | +타입 | +필수 | +
|---|---|---|---|
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
| msgGroupId | +메시지 그룹 ID | +String | +O | +
| page | +페이지 번호 | +String | +X | +
| pageSize | +페이지당 출력 개수 | +String | +X | +
| test_yn | +테스트 데이터 여부 | +String | +X | +
+
+ ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+
+
+
+
+ [Example]
+
+
+ ｛
+
+
+ "mberId":"홍길동"
+,"accessKey":"XXXXXXXXXXXXXX414050694b953"
+,"msgGroupId":"MSGGID_0000000011452"
+,"page":""
+,"pageSize":""
+,"test_yn":""
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].message | +문자 | +String | +
| [data].next_yn | +다음 페이지 여부 | +String | +
| [data].objectList | +결과값 목록 | +Object List | +
| [data].msgGroupId | +메시지 그룹 ID | +String | +
| [data].msgId | +메시지 ID | +String | +
| [data].msgTypeName | +문자 구분명(단문, 장문, 그림) | +String | +
| [data].msgType | +메시지 타입(4 : 단문, 5 : 장문) | +String | +
| [data].callFrom | +발신자 번호 | +String | +
| [data].callTo | +수신자 번호 | +String | +
| [data].msgGroupCnt | +문자 발송 건수 | +String | +
| [data].sCnt | +성공 건수 | +String | +
| [data].fCnt | +실패 건수 | +String | +
| [data].wCnt | +대기 건수 | +String | +
| [data].msgResult | +발송 결과(성공 : S, 실패 : F) | +String | +
| [data].smsTxt | +문자 내용 | +String | +
| [data].subject | +제목 | +String | +
| [data].reqdate | +발송 일자 | +String | +
| [data].curState | +전송 처리 결과값 | +String | +
| [data].userId | +사용자 ID | +String | +
| [data].regdate | +등록 일자 | +String | +
| [data].reserveCYn | +예약 취소 여부 | +String | +
| [data].ttlCnt | +전체 요청 수 | +String | +
| [data].remainMsgCnt | +남은 문자 건수 | +String | +
| [data].totMsgCnt | +전체 문자 개수 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
+ [Example]O 성공 예시
+
+
+ ｛
+
+
+ "resultCode":"0"
+,"data":［
+｛
+
+
+ "resultCode":"0"
+,"message": null
+,"next_yn":"n"
+,"msgGroupId":"MSGGID_0000000000000"
+,"objectList":［
+｛
+
+
+ "msgTypeName":"단문(SMS)"
+,"msgType":"4"
+,"callFrom":"01011112222"
+,"callTo":"01011112223"
+,"msgGroupCnt":"2"
+,"msgGroupId":"MSGGID_0000000013340"
+,"msgId":"MSGID_0000000000001"
+,"scnt":null
+,"fcnt":null
+,"wcnt":null
+,"msgResult":"S"
+,"smsTxt":"문자 내용 단문 예제"
+,"subject":null
+,"reqdate":"2023-06-13 17:48:08"
+,"curState":"3"
+,"userId":"testuser"
+,"regdate":"2023-06-13 17:48:07"
+,"reserveCYn":"N"
+,"ttlCnt":"10"
+,"remainMsgCnt":"0"
+,"totMsgCnt":"10"
+｝
+,｛
+
+
+ "msgTypeName":"단문(SMS)"
+,"msgType":"4"
+,"callFrom":"01011112222"
+,"callTo":"01011112223"
+,"msgGroupCnt":"2"
+,"msgGroupId":"MSGGID_0000000013340"
+,"msgId":"MSGID_0000000000002"
+,"scnt":null
+,"fcnt":null
+,"wcnt":null
+,"msgResult":"S"
+,"smsTxt":"문자 내용 단문 예제"
+,subject":null
+,reqdate":"2023-06-13 17:48:09"
+,"curState":"3"
+,"userId":"testuser"
+,"regdate":"2023-06-13 17:48:07"
+,"reserveCYn":"N"
+,"ttlCnt":"10"
+,"remainMsgCnt":"0"
+,"totMsgCnt":"10"
+｝
+］
+｝
+］
+｝
+
+
+
+ [Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"4099"
+,"data":"기타 시스템 오류"
+｝
+
+
+
+ -
+
- - 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다. +
- - 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다. +
+
+
+ Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
+
+
+
+ | 키 | +설명 | +타입 | +필수 | +
|---|---|---|---|
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
+
+ ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+
+
+
+
+ [Example]
+
+
+ ｛
+
+
+ "mberId":"String"
+,"accessKey":"String"
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].longPrice | +장문 단가 | +String | +
| [data].longSendPsbltEa | +장문 발송 가능 건수 | +String | +
| [data].mberMoney | +현재 보유 금액 | +String | +
| [data].message | +문자 | +String | +
| [data].picturePrice | +그림문자 단가 | +String | +
| [data].pictureSendPsbltEa | +그림문자 발송 가능 건수 | +String | +
| [data].shortPrice | +단문 단가 | +String | +
| [data].shortSendPsbltEa | +단문 발송 가능 건수 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
+ [Example]O 성공 예시
+
+
+ ｛
+
+
+ "resultCode":"0"
+,"data"｛
+
+
+ "longPrice":"50"
+,"longSendPsbltEa":"19651"
+,"mberMoney":"982586.7"
+,"message":null
+,"picturePrice":"90"
+,"pictureSendPsbltEa":"10917"
+,"shortPrice":"18"
+,"shortSendPsbltEa":"54588"
+｝
+｝
+
+
+
+ [Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"5099"
+,"data":"기타 시스템 오류"
+｝
+
+
+
+ -
+
- - 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다. +
- - 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다. +
+
+
+ Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
+
+
+
+ | 키 | +설명 | +타입 | +필수 | +
|---|---|---|---|
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
+
+ ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+
+
+
+
+ [Example]
+
+
+ ｛
+
+
+ "mberId":"String"
+,"accessKey":"String"
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].longPrice | +장문 단가 | +String | +
| [data].longSendPsbltEa | +장문 발송 가능 건수 | +String | +
| [data].mberMoney | +현재 보유 금액 | +String | +
| [data].message | +문자 | +String | +
| [data].picturePrice | +그림문자 단가 | +String | +
| [data].pictureSendPsbltEa | +그림문자 발송 가능 건수 | +String | +
| [data].shortPrice | +단문 단가 | +String | +
| [data].shortSendPsbltEa | +단문 발송 가능 건수 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
+ [Example]O 성공 예시
+
+
+ ｛
+
+
+ "resultCode":"0"
+,"data"｛
+
+
+ "longPrice":"50"
+,"longSendPsbltEa":"19651"
+,"mberMoney":"982586.7"
+,"message":null
+,"picturePrice":"90"
+,"pictureSendPsbltEa":"10917"
+,"shortPrice":"18"
+,"shortSendPsbltEa":"54588"
+｝
+｝
+
+
+
+ [Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"5099"
+,"data":"기타 시스템 오류"
+｝
+
+
+
+ -
+
- - 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다. +
- - 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다. +
+
+
+ Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
+
+
+
+ | 키 | +설명 | +타입 | +필수 | +
|---|---|---|---|
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
+
+ ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+
+
+
+
+ [Example]
+
+
+ ｛
+
+
+ "mberId":"String"
+,"accessKey":"String"
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].longPrice | +장문 단가 | +String | +
| [data].longSendPsbltEa | +장문 발송 가능 건수 | +String | +
| [data].mberMoney | +현재 보유 금액 | +String | +
| [data].message | +문자 | +String | +
| [data].picturePrice | +그림문자 단가 | +String | +
| [data].pictureSendPsbltEa | +그림문자 발송 가능 건수 | +String | +
| [data].shortPrice | +단문 단가 | +String | +
| [data].shortSendPsbltEa | +단문 발송 가능 건수 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
+ [Example]O 성공 예시
+
+
+ ｛
+
+
+ "resultCode":"0"
+,"data"｛
+
+
+ "longPrice":"50"
+,"longSendPsbltEa":"19651"
+,"mberMoney":"982586.7"
+,"message":null
+,"picturePrice":"90"
+,"pictureSendPsbltEa":"10917"
+,"shortPrice":"18"
+,"shortSendPsbltEa":"54588"
+｝
+｝
+
+
+
+ [Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"5099"
+,"data":"기타 시스템 오류"
+｝
+
+
+
-
+
- - 보유캐시로 발송 가능한 문자의 건수를 단문(SMS), 장문(LMS), 그림(MMS)별로 각각 확인할 수 있습니다. +
- - 위 문자유형별 발송 가능건수는 개인별로 적용된 단가를 기준으로 산출되며, "첫결제 이벤트"는 적용되지 않습니다. +
+
+
+ Request
+
+
+
+
+
+
+ Request
+| Http Method | +POST | +
|---|---|
| 프로토콜 | +HHTP/1.1 | +
| HOST | +api.munjaon.co.kr | +
| Service Port | +443 | +
+
+
+
+ | 키 | +설명 | +타입 | +필수 | +
|---|---|---|---|
| mberId | +사용자 ID | +String | +O | +
| accessKey | +인증용 API Key | +String | +O | +
+
+ ※ HTTPS 프로토콜을 사용하여 POST로 요청합니다.
+
+
+
+
+ [Example]
+
+
+ ｛
+
+
+ "mberId":"String"
+,"accessKey":"String"
+｝
+Response
+
+
+
+
+ | 키 | +설명 | +타입 | +
|---|---|---|
| resultCode | +성공 여부("0" 아니면 실패) | +String | +
| data | +결과값 객체(성공 : 데이터, 실패 : 메시지) | +Object | +
| [data].longPrice | +장문 단가 | +String | +
| [data].longSendPsbltEa | +장문 발송 가능 건수 | +String | +
| [data].mberMoney | +현재 보유 금액 | +String | +
| [data].message | +문자 | +String | +
| [data].picturePrice | +그림문자 단가 | +String | +
| [data].pictureSendPsbltEa | +그림문자 발송 가능 건수 | +String | +
| [data].shortPrice | +단문 단가 | +String | +
| [data].shortSendPsbltEa | +단문 발송 가능 건수 | +String | +
+
+ ※ JSON 객체로 응답합니다.
+
+
+ [Example]O 성공 예시
+
+
+ ｛
+
+
+ "resultCode":"0"
+,"data"｛
+
+
+ "longPrice":"50"
+,"longSendPsbltEa":"19651"
+,"mberMoney":"982586.7"
+,"message":null
+,"picturePrice":"90"
+,"pictureSendPsbltEa":"10917"
+,"shortPrice":"18"
+,"shortSendPsbltEa":"54588"
+｝
+｝
+
+
+
+ [Example]X 실패 예시
+
+
+ ｛
+
+
+ "resultCode":"5099"
+,"data":"기타 시스템 오류"
+｝
+