API Reference

문자(SMS)

문자관련 Api Reference를 설명합니다.

문자전송(SEND)

구분	제한사항
SMS	90바이트 까지 전송가능
LMS	2,000바이트 까지 전송가능
MMS	2,000바이트 텍스트, 1개의 이미지 전송

Parameters :

• to - 받는사람 번호

• from - 보내는사람 번호

• text - 문자내용

• type - 문자 타입

• app_version - 어플리케이션 버젼 예) Purplebook 4.1

• to - 받는사람 번호 여러개 입력시

• image_path - image file path 이미지 파일 경로 설정 (기본 "./")

• image - image file (지원형식 : 200KB 이하의 JPEG)

• refname - 참조내용

• country - 국가코드 한국:KR 일본:JP 미국:US 중국:CN

• datetime - 예약전송시 날짜 설정

• subject - LMS, MMS 일때 제목

• charset - 인코딩 방식

• srk - 솔루션 제공 수수료를 정산받을 솔루션 등록키

• mode - test모드 수신번호를 반드시 01000000000 으로 테스트하세요. 예약필드 datetime는 무시됨. 결과값은 60. 잔액에서 실제 차감되며 다음날 새벽에 재충전됨

• extension - 개별문자 보내기

Return : 아래와 같이 JSONObject 형태로 return

{
  'recipient_number': '01012345678',
  'group_id': '20120217103829612403761364',
  'message_id': '20120217103830163531890062',
  'result_code': '00',
  'result_message': 'Success'
}

전송결과(SENT)

Parameters :

• mid - message_id

• gid - group_id

• count - count

• page - page

• s_rcpt - 수신번호

• s_start - 검색 시작 날짜

• s_end - 검색 종료 날짜

Return : 아래와 같은 구조로 return

{
  'total_count':169,
  'list_count':4,
  'page':1,
  'data':[
    {
      'type':'SMS',
      'accepted_time':'2014-01-07 18:14:54',
      'recipient_number':'01000000000',
      'group_id':'G52CBC596955F0',
      'message_id':'M52CBC59695B31',
      'status':'2',
      'result_code':'58',
      'result_message':'\uc804\uc1a1\uacbd\ub85c \uc5c6\uc74c',
      'sent_time':'201401071814',
      'text':'Test Message'
    },
    {
      'type':'SMS',
      'accepted_time':'2014-01-07 18:14:41',
      'recipient_number':'01000000000',
      'group_id':'G52CBC5897645A',
      'message_id':'M52CBC58976A64',
      'status':'2',
      'result_code':'58',
      'result_message':'\uc804\uc1a1\uacbd\ub85c \uc5c6\uc74c',
      'sent_time':'201401071814',
      'text':'message\nhere'
    }
  ]
}

잔액확인(BALANCE)

Parameters :

• 없음

Return : 아래와 같이 JSONObject 형태로 return

{
  'cash': '0',
  'point': '15121',  
}

예약취소(CANCEL)

Parameters :

• mid - message_id

• gid - group_id

Return : Return값이 없습니다.

None

발신번호(SENDERID)

등록요청(REGISTER)

* 보안상 문제로 현재는 제공하지 않습니다. 쿨에스엠에스 사이트에서 발신번호를 등록해 주세요

Parameters :

• site_user - 사이트 유저 아이디 입력, 미입력시 __private__ 으로 설정됩니다. 예) admin

• phone - 발신번호 예) 021234567

Return : 아래와 같이 JSONObject 형태로 return

{
  'handle_key': 'CI283910CCKKI91',
  'ars_number': '01000000000'
}

등록확인(VERIFY)

* 보안상 문제로 현재는 제공하지 않습니다. 쿨에스엠에스 사이트에서 발신번호를 등록해 주세요

Parameters :

• handle_key - register 호출 후 리턴받은 핸들값

Return : Return값이 없습니다.

None

삭제(DELETE)

Parameters :

• handle_key - register 호출 후 리턴받은 핸들값

Return : Return값이 없습니다.

None

리스트보기(LIST)

Parameters :

• site_user - 사이트 유저 아이디 입력, 미입력시 __private__ 으로 설정됩니다. 예) admin

Return : 아래와 같이 JSONObject 형태로 return

{
  "data":
  [
     {
       "regdate":"2015-08-07 12:21:33",
       "phone_number":"01000000001",
       "updatetime":"2015-08-21 18:09:10",
       "idno":"SID55C4FFFDDA2",
       "flag_default":"Y"
     },
     {
       "regdate":"2015-08-21 14:45:01",
       "phone_number":"01000000002",
       "updatetime":"2015-08-21 15:09:43",
       "idno":"SID55SSSD9FAB6",
       "flag_default":"N"
      }
  ,"status":true
}

기본발신번호설정(SET_DEFAULT)

Parameters :

• site_user - 사이트 유저 아이디 입력, 미입력시 __private__ 으로 설정됩니다. 예) admin

• handle_key - 발신번호 핸들값을 입력

Return : Return값이 없습니다.

None

기본발신번호보기(GET_DEFAULT)

Parameters :

• site_user - 사이트 유저 아이디 입력, 미입력시 __private__ 으로 설정됩니다. 예) admin

• phone - 발신번호 예) 021234567

Return : 아래와 같이 JSONObject 형태로 return

{
  'handle_key': 'CI283910CCKKI91',
  'ars_number': '01000000000'
}