MO API 1.0

Overview

이 문서는 일반적으로 컴퓨터에서 휴대전화 단말기로 문자를 발송하는 MT의 반대되는 개념인 MO 서비스와 연동하기 위한 SMS MO API를 설명합니다.

 

죄송합니다. MO 서비스는 현재 제공되지 않습니다.

 

MO 서비스에 대해서는 http://www.coolsms.co.kr/Man_Mo_Service 페이지를 참고 하세요.

 

아래 테이블은 MO API의 Resource에 대한 요약 설명입니다. 상세한 설명을 위해서 해당 Resource를 클릭하세요.

Resource Description
GET list 수신된 문자메시지 읽어오기
POST insert 문자메시지 입력

 

모든 Request 호출에는 API Key를 비롯한 인증정보를 포함하여 서버의 인증을 거쳐야 합니다. 인증에 대한 상세한 내용은 Authentication 을 확인하세요.

 

인증을 위한 API Key 및 API Secret 코드는 문자메시지 > 환경설정 > API Key 관리 메뉴에서 발급 및 관리가 가능합니다. 상세한 내용은 API Key 관리 문서를 참고하세요.

 

용어

MT : Mobile Terminated의 약자로 컴퓨터에서 휴대전화 단말기로 보내는 문자메시지

MO : Mobile Originated의 약자로 휴대전화 단말기에서 컴퓨터로 보내는 문자메시지

 

MO 서비스 개설

http://www.coolsms.co.kr/moservice 에서 MO번호를 개설한 후 API 연동이 가능합니다.

 

API Key 발급

https://www.coolsms.co.kr/index.php?mid=service_setup&act=dispSmsconfigCredentials 에서 API Key를 발급받고 SMS MO를 활성화 시키고 연동할 MO번호를 추가해주세요.

GET list

API Key와 연동된 MO번호로 접수된 문자메시지를 리턴합니다.

Resource URL

https://api.coolsms.co.kr/mo/1/list

Parameters

Mandatory Field Description
O 인증정보 인증데이터는 필수입니다. Authentication 참고
  count

기본값 20이며 20개의 목록을 받을 수 있음. 40입력시 40개의 목록이 리턴

  page 1부터 시작하는 페이지값
  start 검색 시작일시 접수 날짜와 시간으로 검색 YYYY-MM-DD HH:MI:SS 포맷의 날짜와 시간
  end 검색 종료일시 접수 날짜와 시간으로 검색 YYYY-MM-DD HH:MI:SS 포맷의 날짜와 시간

Example Request

GET
https://api.coolsms.co.kr/mo/1/list?api_key=_API_KEY_&timestamp=_TIMESTAMP_&salt=_SALT_&signature=_SIGNATURE_&count=20&page=1&start=2015-01-01%2000:00:00&end=2015-01-23%2023:23:59

Example Result

{
  "total_count":"3",
  "list_count":"20",
  "page":1,
  "data":[
    {
      "mo_key":"newrs6_0000443100075514",
      "mo_recipient":"#1333",
      "emo_recipient":"1057",
      "mo_originator":"01000000001",
      "content":"MO TEST 1",
      "carrier":"10001"
    },
    {
      "mo_key":"newrs6_0000443100075515",
      "mo_recipient":"#1333",
      "emo_recipient":"1057",
      "mo_originator":"01000000002",
      "content":"MO TEST 2",
      "carrier":"10002"
    },
    {
      "mo_key":"newrs6_0000443100075516",
      "mo_recipient":"#1333",
      "emo_recipient":"1057",
      "mo_originator":"01000000003",
      "content":"MO TEST 3",
      "carrier":"10003"
    }
  ]
}

 

POST insert 

임의의 문자메시지를 MO번호 아래로 추가합니다.

일반적인 MO 서비스 연동의 경우 이 리소스를 사용할 일이 없습니다.

Resource URL

https://api.coolsms.co.kr/mo/1/insert

Parameters

Mandatory Field Description
O 인증정보 인증데이터는 필수입니다. Authentication 참고
O mo_number

메시지를 추가할 MO 번호

O sender_id 발신번호
O content 문자메시지 내용

Example Request

POST
https://api.coolsms.co.kr/mo/1/insert?api_key=_API_KEY_&timestamp=_TIMESTAMP_&salt=_SALT_&signature=_SIGNATURE_&mo_number=01012345678&sender_id=01087654321&content=TEST%20MO%20MESSAGE