대량문자API연동 (with directsend)

Save this PDF as:
 WORD  PNG  TXT  JPG

Size: px
Start display at page:

Download "대량문자API연동 (with directsend)"

Transcription

1 1 삼정데이타서비스 DIRECTSEND 제공 [ 저작권안내 ] 본문서는삼정데이타서비스 ( 주 ) 에서고객의원활한업무지원을위하여무상으로배포하는사용자매뉴얼및가이드로써저작권과전송권은삼정데이타서비스 ( 주 ) 에있습니다. 따라서당사고객이이를이러한용도로사용하는것에는제한이없으나저작권자에대한허락및표시없이이를제 3 자에게재전송하거나복사및무단전제할때는국내및국제저작권법에의하여서비스이용이제한되고법적인책임이따를수있습니다.

2 1 차례 1. 로그인 APIKEY 확인하기 API 연동관리. 4~5 3-1 PHP 연동하기 ASP 연동하기... 5 소스확인결과값보기. 6

3 1. 로그인 1-1. 웹브라우저를이용하여접속하는방법 웹브라우저를이용하여 directsend 에접속합니다. 사이트 URL: 2 초기화면우측상단에있는 [ 로그인 ] 을클릭하면회원 로그인팝업이나타납니다. 아이디와비밀번호를입력하고 [ 로그인 ] 을클릭합니다. 이용자 ID 및비밀번호를잊은경우에는 ID/PW 찾기기능을 이용하시기바랍니다.

4 2. API Key 발급하기 3 주소록 > API 연동관리로이동하시면 API Key 와 Return_Url 을관리하고, 하단에매뉴얼도확인할수있습니다. 1) API 키확인주소록 > API 연동관리로이동하여회원가입시발급된고유 API 키를확인할수있습니다. 2) 발송결과리턴 URL 관리 API 발송결과를리턴받을 URL 주소를관리할수있습니다. 문자발송결과, 메일발송결과, 메일상세결과 ( 오픈 / 클릭 / 수신거부 ) 의결과를받을 URL 주소를등록하거나삭제할수있습니다. 등록한번호를소스파일에입력하여사용합니다. 3) API 연동파일예제 / 매뉴얼다운받기 API 리스트하단에매뉴얼과연동파일을다운받을수있도록대량메일, 대량문자를개발언어별로구분하여제공하고있습니다.

5 3. API 연동설정 (PHP) 다운받은 API 중 PHP 소스코드파일을열어, 변경해야할변수값을입력한후사이트에업로드하시면됩니다. 4 # 수정위치 3-1 PHP 연동하기 PHP 변수값입력하기! 안내된부분을변경하시면되며, 하단에사용설정하실부분의주석을해제하셔야값이전달됩니다. Title : MMS/LMS 발송시사용하는제목입니다. ( 최대 40byte) Message : 메시지내용입니다. ( 최대 2000byte) Sender : 사이트에인증된발송번호 Username : DirectSend 로그인 ID Recipients : 받는이의전화번호입니다., 로구분할수있습니다. Key : 회원가입시발급받은 Api Key 를넣어줍니다. Return_url : 결과값을받을리턴 URL 등록번호를넣어줍니다. Attaches : MMS 이미지발송시사용합니다. PHP 소스등록후확인하기! 1 PHP 소스수정후이용할사이트 ( 경로 ) 에등록해주세요. 2 3 인터넷브라우저를열어소스코드파일이저장된경로 (URL) 와파일명 (XXX.php) 를입력합니다. 결과값이 {status : 0} 이라고표시되면정상등록되어설정대로 SMS 가정상적으로발송됩니다. ( 결과값종류는마지막페이지를확인해주세요!) 4 euckr 로인코딩에실패한문자열이있는경우 {"status":112, "text": 풰 (13)} 와같은결과가표시됩니다. 해당문자열과위치로표시되며실패문자열을제외하고발송해주시기바랍니다. 5 Return_url 을설정한경우다음과같이결과가리턴됩니다.

6 3. API 연동설정 다운받은 API 중 ASP 소스코드파일을열어, 변경해야할변수값을입력한후사이트에업로드하시면됩니다. 5 # 수정위치 3-2 ASP 연동하기 ASP 변수값입력하기! 안내된부분을변경하시면되며, 하단에사용설정하실부분의주석을해제하셔야값이전달됩니다. Title : MMS/LMS 발송시사용하는제목입니다. ( 최대 40byte) Message : 메시지내용입니다. ( 최대 2000byte) Sender : 사이트에인증된발송번호 Username : DirectSend 로그인 ID Recipients : 받는이의전화번호입니다., 로구분할수있습니다. Key : 회원가입시발급받은 Api Key 를넣어줍니다. Return_url : 결과값을받을리턴 URL 등록번호를넣어줍니다. Attaches : MMS 이미지발송시사용합니다. ASP 소스등록후확인하기! 1 ASP 소스수정후이용할사이트 ( 경로 ) 에등록해주세요. 2 3 인터넷브라우저를열어소스코드파일이저장된경로 (URL) 와파일명 (XXX.ASP) 를입력합니다. 결과값이 {status : 0} 이라고표시되면정상등록되어설정대로 SMS 가정상적으로발송됩니다. ( 결과값종류는마지막페이지를확인해주세요!) 4 euckr 로인코딩에실패한문자열이있는경우 {"status":112, "text": 풰 (13)} 와같은결과가표시됩니다. 해당문자열과위치로표시되며실패문자열을제외하고발송해주시기바랍니다. 5 Return_url 에도메인을설정한경우다음과같이결과가리턴됩니다.

7 소스확인결과값보기 6 Code Message 설명 0 정상발송 정상적으로발송가능한상태입니다. 100 Post Validation 실패 URL 필수파라미터의데이터가없을경우발송이되지않으니수정하지마시기바랍니다. 101 Sender 번호가유효한번호가아닙니다. 발송자의번호가인증되었는지를확인후발송해주시기바랍니다. 102 Recipient 번호가유효한번호가아닙니다. 받는사람의번호가잘못등록되어발송되지않으니수정해주세요 103 회원정보가일치하지않음 User name 과 key 가일치하지않는문제입니다. 확인후다시입력바랍니다. 104 Recipient 가없습니다. 받는사람의정보가없어발송을할수없습니다. 105 Message 가없습니다. 제목은 40byte 이하, 내용은 2000byte 이하로작성해주세요 106 Message validation 실패 본문에금지어가존재합니다. 금지된내용은발송할수없습니다. 107 MMS 이미지업로드실패 첨부하실이미지를다시한번확인하고이상이없는경우고객센터로문의바랍니다. 108 이미지갯수초과 MMS 첨부이미지갯수는 3 개이하로만가능합니다. 109 return_url 이유효하지않습니다. 결과값을전달받을 Return_url 이없습니다. url 번호를입력해주시기바랍니다. 110 이미지용량 300kb 초과 MMS 첨부이미지는 300KB 를초과할수없습니다. 111 이미지확장자오류 MMS 첨부이미지는 jpg, jpeg 로만업로드하실수있습니다. 205 잔액부족 충전이후발송하시기바랍니다. 999 기타에러 등록된내용을다시한번확인하고이상이없는경우고객센터로문의바랍니다.