문자 API 단건 / 대량 전송방법 안내

2017.07.28

안녕하세요. 고객사와 함께 성장하는 비즈니스 파트너 링크허브 입니다.

링크허브의 문자 API는 문자를 한건씩 전송하는 ‘단건전송’과, 다량으로 전송하는 ‘대량전송’ 방법을 제공하고 있습니다. 다음은 문자 API의 요청전문을 구성하는 항목과 요청/응답 전문의 예시를 들어 설명해 드리도록 하겠습니다.

링크허브 홈페이지 연동자료실에서 제공하는 SDK에 개발언어별로 상세한 예제코드가 참고하시기 바랍니다.

문자 API 요청전문 구성항목

단건 전송

문자메시지 단건전송 요청전문 항목은 아래와 같습니다.

항목 변수명 타입 설명
광고문자 여부 adsYN Boolean

광고문자 표기 의무에 따라 메시지 전송

단, 080 수신거부 서비스 이용이 가능해야 한다.

예약일시 sndDT String

작성형식 : yyyyMMddHHmmss, 미기재시 즉시전송

전송정보 배열 msgs[] Array 문자 전송정보 배열, 최대 1000개
발신자 번호 snd String [필수] 발신자 번호 기재
수신번호 rcv String [필수] 수신자 번호 기재
수신자명 rcvnm String 수신자명 기재
메시지 내용 msg String 메시지 내용, SMS(90Byte), LMS(2,000Byte)

대량 전송

문자메시지 대량전송 요청전문 항목은 아래와 같습니다.

항목 변수명 타입 설명
발신번호 snd String [필수] 발신자 번호 기재
메시지 내용 content String 전송할 메시지 내용 기재
광고문자 여부 adsYN Boolean

광고문자 표기 의무에 따라 메시지 전송

단, 080 수신거부 서비스 이용이 가능해야 한다.

예약일시 sndDT String

작성형식 : yyyyMMddHHmmss, 미기재시 즉시전송

전송정보 배열 msgs[] String 문자 전송정보 배열, 최대 1000개
수신번호 rcv String [필수] 수신자 번호 기재
수신자명 rcvnm String 수신자명 기재

대량전송이란?

대량전송이란 다수의 수신자에게 동일한 메시지 내용을 전송하는 경우에 사용하는 기능입니다. 링크허브에서 제공하는 문자 API는 요청정보 구성을 조합하여 단건전송, 대량전송, 부분대량전송이 가능합니다. 아래의 예시를 참조하여 문자전송 API를 호출하시기 바랍니다.

문자 전송정보 요청전문 구성예시

  • 예시1 – 다수의 수신자에게 각각 다른 발신자번호로 다른 메시지 내용을 전송하는 경우
  • 예시2 – 다수의 수신자에게 동일한 발신자번호로 동일한 메시지 내용을 전송하는 경우
  • 예시3 – 다수의 수신자에게 각각 다른 발신자번호로 동일한 메시지 내용을 전송하는 경우
  • 예시4 – 예시1과 예시2의 방법을 혼합하여 전송하는 경우
예시1 – 단건 개별전송 예시2 – 대량전송

{

  • “adsYN” : false, //광고문자 전송여부
  • “msgs”:
  • [
  • {

    • “snd” : “07043042991”,
    • “rcv” : “01011112222”,
    • “rcvnm” : “홍길동”,
    • “msg” : “메시지내용”

    },

    {

    • “snd” : “07043042991”,
    • “rcv” : “01022223333”,
    • “rcvnm” : “김철수”,
    • “msg” : “메시지내용”

    },

    //배열 반복(최대 1000건)

  • ]

}

{

  • “snd” : “07043042991”,
  • “content” : “대량전송 내용.”,
  • “adsYN” : false, //광고문자 전송여부
  • “msgs” :
  • [
  • {

    • “rcv” : “01011112222”,
    • “rcvnm” : “홍길동”,

    },

    {

    • “rcv” : “01022223333”,
    • “rcvnm” : “김철수”,

    },

    //배열 반복(최대 1000건)

  • ]

}

예시3 – 대량전송 예시4 – 부분 대량전송

{

  • “content” : “대량전송 내용.”,
  • “adsYN” : false, //광고문자 전송여부
  • “msgs” :
  • [
  • {

    • “snd” : “07043042991”,
    • “rcv” : “01011112222”,
    • “rcvnm” : “홍길동”,

    },

    {

    • “snd” : “07043042991”,
    • “rcv” : “01022223333”,
    • “rcvnm” : “김철수”,

    },

    //배열 반복(최대 1000건)

  • ]

}

{

  • “snd” : “07043042991”,
  • “content” : “대량전송 내용.”,
  • “adsYN” : false, //광고문자 전송여부
  • “msgs”:
  • [
  • {

    • “rcv” : “01011112222”,
    • “rcvnm” : “홍길동”,

    },

    {

    • “snd” : “07043042991”,
    • “rcv” : “01011112222”,
    • “rcvnm” : “홍길동”,
    • “msg” : “메시지내용”

    },

    //배열 반복(최대 1000건)

  • ]

}

지금까지 링크허브에서 제공하는 문자전송 API의 단건전송, 대량전송, 부분대량전송에 대해 안내해 드렸습니다. 문자전송 전송에 대한 자세한 사항은 [문자전송 API 프로세스] 참조하시기 바랍니다.

고객님들의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락주시기 바랍니다.

링크허브 개발팀 정요한 과장 / T.1600-9854 / D. 070-4304-2991/ E. code@linkhub.co.kr