Quick Start
Step 01
가입 인증 완료와 동시에 ToBeText API를 사용하실수 있도록 CID 및 TOKEN을 발급 됩니다.
은 ToBeText API를 이용하기 위한 필수 인증 열쇠와 같습니다.
CID 와 Token 을 가지고 있으면 SMS를 전송하거나 Voice SMS 와 같은 ToBeText에서 제공하는 모든 기능을 이용 하실수 있습니다.
Step 02
ToBeText API를 이용하여 SMS를 요청 합니다.
‘홍길동’ 씨는 당신의 사이트에 가입하기 위해 본인 인증 SMS 받기를 요청합니다.
http://api-dev.tbnws.com/sms/
‘홍길동’ 씨는 아래와 같이 요청을 합니다.
import java.io.BufferedReader; import java.io.DataOutputStream; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; import javax.net.ssl.HttpsURLConnection; public class sendSMS { public static void main(String[] args) throws Exception { sendSMS SMS = new sendSMS(); SMS.sendExample(); } private void sendExample() throws Exception { String USER_AGENT = "Mozilla/5.0"; String url = "http://api-dev.tbnws.com/sms/"; URL obj = new URL(url); HttpURLConnection httpcon = (HttpURLConnection) obj.openConnection(); // HttpsURLConnection httpcon = (HttpsURLConnection) obj.openConnection(); // SSL connection httpcon.setRequestMethod("POST"); httpcon.setRequestProperty("User-Agent", USER_AGENT); httpcon.setRequestProperty("Accept-Language", "en-US,en;q=0.5"); StringBuffer urlParameters = new StringBuffer(); urlParameters.append("Ckey= 메시지 ID"); urlParameters.append("&RecvNum= 수신전화번호 입력"); urlParameters.append("&SendNum= 발신전화번호 입력"); urlParameters.append("&Body= 메시지 본문 입력"); urlParameters.append("&Cid= ToBeText 에서 발급받은 고객님의 CID 입력"); urlParameters.append("&token= ToBeText 에서 발급받은 고객님의 token 입력"); urlParameters.append("&callback= 상태 값 Callback URL"); System.out.println("\n\nrequest to URL : " + url); System.out.println("\n\nparameters : " + urlParameters); // Send post request httpcon.setDoOutput(true); DataOutputStream ostream = new DataOutputStream(httpcon.getOutputStream()); ostream.writeBytes(urlParameters.toString()); ostream.flush(); ostream.close(); int responseCode = httpcon.getResponseCode(); System.out.println("\n\nResponse Code : " + responseCode); BufferedReader in = new BufferedReader(new InputStreamReader(httpcon.getInputStream())); String inputLine; StringBuffer response = new StringBuffer(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } in.close(); System.out.println(response.toString()); } }
curl -X POST http://api-dev.tbnws.com/sms -d 'Ckey = 메시지 ID' -d 'RecvNum = 수신전화번호 입력' -d 'SendNum = 발신전화번호 입력' -d 'Body = 메시지 본문 입력' -d 'Cid = TOBE TEXT에서 발급받은 고객님의 CID 입력' -d 'token = TOBE TEXT에서 발급받은 고객님의 token 입력' -d 'Appid = Appid' -d 'ACode = ACode' -d 'callback = 상태 값 Callback URL'
<?php $url = 'http://api-dev.tbnws.com/sms'; $post_data["Ckey"] = "메시지 ID"; $post_data["RecvNum"] = "수신 전화번호"; $post_data["SendNum"] = "발신 전화번호"; $post_data["Body"] = "메시지내용"; $post_data["Cid"] = "고객님의 CID 입력 "; $post_data["token"] = "고객님의 TOKEN 입력"; $post_data["Appid"] = "Appid"; $post_data["callback"] = "상태 값 Callback URL"; $curlsession = curl_init (); curl_setopt ($curlsession, CURLOPT_URL, $url); curl_setopt ($curlsession, CURLOPT_POST, 1); curl_setopt ($curlsession, CURLOPT_POSTFIELDS, $post_data); curl_setopt ($curlsession, CURLOPT_RETURNTRANSFER, 1); $res = curl_exec ($curlsession); var_dump($res); //결과값 출력 curl_close($curlsession); ?>
위 예제에서 알 수 있듯이 ‘Outbound SMS’ 발송을 위해서는 6가지의 필수값과 1가지의 Callback URL을 담아 ToBeText 에 요청을 하여야 합니다.
1. Ckey (고객의 메시지 ID) : 추후 결과 값 전송시 해당 메시지의 식별 값을 전달 위해 필요. (필수)
2. RecvNum (수신전화번호) : SMS 를 받을 고객의 전화번호. (필수)
3. SendNum (발신전화번호) : SMS 를 발신 번호 / 해외의 경우 지정된 번호로 자동 변경 됨. (필수)
4. Body (메시지 내용) : 메시지 내용. 160byte 이내 (영문 160자, 다국어 포함시 80자). (필수)
5. Cid (고객사 고유 번호) : ToBeText 가입 시 제공하는 CID 값. (필수)
6. token (고객사 인증 토큰) : ToBeText 가입 시 제공하는 TOKEN 값. (필수)
7. callback (전송결과 Call Back URL) : SMS 발송 전송결과을 받을 URL. (선택)
요청하신 발송코드 생성이 무사히 완료되면, ToBeText 는 아래와 같이 응답합니다.
<ToBeTextResult> <Status>SUCCESS</Status> <MsgId>41aa33709703dea382c10a057823ffdc</MsgId> <SendNum>821012341234</SendNum> <RecvNum>821012341234</RecvNum> <ErrorCode>200</ErrorCode> <ErrorMsg>Msg sent successfully</ErrorMsg> </ToBeTextResult> |
ErrorCode ‘200’은 ‘성공’을 나타냅니다.
MsgId 는 발송한 문자 메시지의 고유 값 입니다.
위와 같이 ToBeText API 를 이용 시 쉽고 간편하게 문자메시지를 전송이 가능합니다.