SMS 서비스

문자메시지(SMS) 서비스 API 규격서

iwinv 문자메시지 서비스  Rest API  규격서 입니다.  

 

 

단문(SMS) 발송

90byte까지 단문으로 발송되며, 90byte가 넘는 경우에는 LMS로 발송됩니다.

 

HEADERS

Content-Type     multipart/form-data

Secret                base64_encode ( API Key&인증 Key )

 

BODY

from                   발신번호 ( 010-0000-0000 or 01000000000 )

to                       수신번호 ( 010-0000-0000 or 01000000000 )

text                    문자 내용 ( 최대 90Byte 초과 시 LMS로 발송됩니다. )

date                   예약 시간('2020-02-02 09:01:00') 또는 빈값(null)은 즉시 발송

 


PHP

$curl = curl_init() ;

curl_setopt ( $curl , CURLOPT_URL , 'https://sms.service.iwinv.kr/send/' ) ;

curl_setopt ( $curl , CURLOPT_TIMEOUT , 0 ) ;

curl_setopt ( $curl , CURLOPT_POST , 1 ) ;

curl_setopt ( $curl , CURLOPT_RETURNTRANSFER , 1 ) ;

curl_setopt ( $curl , CURLOPT_POSTFIELDS , array ( 'from' => '01000000000' , 'to' => '01000000000' , 'text' => 'SMS TEST MESSAGE' , 'date' => NULL ) ) ;

curl_setopt ( $curl , CURLOPT_HTTPHEADER ,

          array

           (

                    'Content-Type:multipart/form-data' ,                   

                    'secret:NjI0RVlHQzBESTdXT1pKRkxITjVFQzQ3NTg4MjkyRTYmMGVlOGMyMDEzNDdmYTMyYjAwMjhmMDJiZWU4MTNiNzUxOWQ5MTkyOTYzNTNlYWIyYjNlYjA5ZTAyZjRhMDAxMA=='  

         )

 ) ; 

 curl_setopt ( $curl , CURLOPT_SSL_VERIFYPEER , FALSE ) ;

  

$result = curl_exec ( $curl ) ;

$err = curl_error($curl);

 

   curl_close($curl);

 

   if ( $err )

         echo 'Error :' . $err ;

 else

         echo $result ;

 

 

 

장문(LMS) 발송

문자에 제목을 추가할 수 있습니다. 문자는 최대 2000Byte까지 입력 가능합니다.

 

HEADERS

Content-Type     multipart/form-data

Secret                base64_encode ( API Key&인증 Key )

  

BODY

from                   발신번호 ( 010-0000-0000 or 01000000000 )

to                       수신번호 ( 010-0000-0000 or 01000000000 )

title                     제목 : 최대 40Byte 허용된 특수문자 [ ] ( ) < >

text                    문자 내용 ( 최대 90Byte 초과 시 LMS로 발송됩니다. )

date                   예약 시간('2020-02-02 09:01:00') 또는 빈값(null)은 즉시 발송

 

PHP

$curl = curl_init() ;

curl_setopt ( $curl , CURLOPT_URL, 'https://sms.service.iwinv.kr/send/' ) ;

curl_setopt ( $curl , CURLOPT_TIMEOUT , 0 ) ;

curl_setopt ( $curl , CURLOPT_POST , 1 ) ;

curl_setopt ( $curl , CURLOPT_RETURNTRANSFER , 1 ) ;

curl_setopt ( $curl , CURLOPT_POSTFIELDS , array ( 'from' => '01000000000' , 'to' => '01000000000' , 'title' => 'LMS TITLE' , 'text' => 'LMS TEST MESSAGE' , 'date' => NULL ) ) ;

curl_setopt ( $curl , CURLOPT_HTTPHEADER ,

       array

      (

             'Content-Type:multipart/form-data' ,

           'secret:NjI0RVlHQzBESTdXT1pKRkxITjVFQzQ3NTg4MjkyRTYmMGVlOGMyMDEzNDdmYTMyYjAwMjhmMDJiZWU4MTNiNzUxOWQ5MTkyOTYzNTNlYWIyYjNlYjA5ZTAyZjRhMDAxMA=='

      )

) ;

curl_setopt ( $curl , CURLOPT_SSL_VERIFYPEER , FALSE ) ;

 

$result = curl_exec ( $curl ) ;

$err = curl_error($curl);

curl_close($curl);

if ( $err )

       echo 'Error :' . $err ;

else

       echo $result ;




포토(MMS) 발송

단문/장문 문자에서 이미지를 첨부하여 발송할 수 있습니다.

이미지는 100kb 미만의 JPG파일만 발송할 수 있습니다.

 

HEADERS

Content-Type     multipart/form-data

Secret                    base64_encode ( API Key&인증 Key )

  

BODY

from                   발신번호 ( 010-0000-0000 or 01000000000 )

to                        수신번호 ( 010-0000-0000 or 01000000000 )

title                    제목 : 최대 40Byte 허용된 특수문자 [ ] ( ) < >

text                    문자 내용 ( 최대 90Byte 초과 시 LMS로 발송됩니다. )

image                 이미지 ( 100kb 미만의 JPG 파일 )

date                   예약 시간('2020-02-02 09:01:00') 또는 빈값(null)은 즉시 발송

 

PHP

 $k = array_keys ( $_FILES ) ;

$image = curl_file_create ( $_FILES[$k[0]]['tmp_name'] , $_FILES[$k[0]]['type'] , basename ( $_FILES[$k[0]]['name'] ) ) ; $curl = curl_init() ;

curl_setopt ( $curl , CURLOPT_URL, 'https://sms.service.iwinv.kr/send/' ) ;

curl_setopt ( $curl , CURLOPT_TIMEOUT , 0 ) ;

curl_setopt ( $curl , CURLOPT_POST , 1 ) ;

curl_setopt ( $curl , CURLOPT_RETURNTRANSFER , 1 ) ;

curl_setopt ( $curl , CURLOPT_POSTFIELDS , array ( 'from' => '01000000000' , 'to' => '01000000000' , 'title' => 'MMS TITLE' , 'text' => 'MMS TEST MESSAGE' , 'image' => $image , 'date' => NULL ) ) ;
curl_setopt ( $curl , CURLOPT_HTTPHEADER ,

array

      (

              'Content-Type:multipart/form-data' ,

             'secret:NjI0RVlHQzBESTdXT1pKRkxITjVFQzQ3NTg4MjkyRTYmMGVlOGMyMDEzNDdmYTMyYjAwMjhmMDJiZWU4MTNiNzUxOWQ5MTkyOTYzNTNlYWIyYjNlYjA5ZTAyZjRhMDAxMA=='

      )

) ;

curl_setopt ( $curl , CURLOPT_SSL_VERIFYPEER , FALSE ) ;

 

$result = curl_exec ( $curl ) ;

 

$err = curl_error($curl);

curl_close($curl);

      if ( $err ) echo 'Error :' . $err ;

else

       echo $result ;

 
 
 

대량 메시지 발송

대량 발송시 수신번호 배열로 입력하시면 됩니다.

대량 발송은 1회 최대 1,000명 전송 가능합니다. 

 

 

공통

to     대량 발송시 수신번호 배열

예)

 

http_build_query ( array ( '01000000000' , '01000000001' ) )
문자 메시지 전송 결과 코드 값
코드 설명
00 전송 성공
01 메시지가 전송되지 않았습니다.
11 운영 중인 서비스가 아닙니다.
12 요금제 충전 중입니다. 잠시 후 다시 시도해 보시기 바랍니다.
13 등록되지 않은 발신번호입니다.
14 인증 요청이 올바르지 않습니다.
15 등록하지 않은 IP에서는 발송되지 않습니다.
21 장문 메시지는 2000 Bytes까지만 입력이 가능합니다.
22 제목 입력 가능 문자 : 한글, 영어, 숫자 허용된 특수문자는 [ ] ( ) < > 입니다.
23 제목은 40 Byte까지만 입력이 가능합니다.
31 파일 업로드는 100KB까지 가능합니다.
32 허용되지 않는 파일 확장자입니다.
33 이미지 업로드에 실패했습니다.
41 수신 번호를 입력하여 주세요.
42 예약 전송은 현재 시간 15분 이후 한달 이전까지만 가능
43 날짜와 시간 표현 형식(예: 2015-09-02 14:17:03)에 맞춰 입력하여 주십시오.
44 최대 1000건 전송 가능합니다.
50 SMS 자동 충전 하루 5번 충전 한도를 초과하였습니다.