Quick Start

Step 01

가입 인증 완료와 동시에 ToBeText API를 사용하실수 있도록 CID 및 TOKEN을 발급 됩니다.

CID 및 TOKEN

은 ToBeText API를 이용하기 위한 필수 인증 열쇠와 같습니다.
CID 와 Token 을 가지고 있으면  SMS를 전송하거나 Voice SMS 와 같은 ToBeText에서 제공하는 모든 기능을 이용 하실수 있습니다.

해당 CID 및 TOKEN은 어딘가에 드러나거나 유출되지 않도록 주의 해야 합니다.

Step 02

ToBeText API를 이용하여 SMS를 요청 합니다.

‘홍길동’ 씨는 당신의 사이트에 가입하기 위해 본인 인증 SMS 받기를 요청합니다.

POST

http://api-dev.tbnws.com/sms/

‘홍길동’ 씨는 아래와 같이 요청을 합니다.

java
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
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
<?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. (선택)

앞서 말씀 드렸듯 CID 및 TOKEN 은 절대 유출되어선 안됩니다. 발송요청 내용이 웹페이지에 그대로 드러나지 않게 다시 한번 주의 해주세요!

요청하신 발송코드 생성이 무사히 완료되면, 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 를 이용 시 쉽고 간편하게 문자메시지를 전송이 가능합니다.

Contact Us

We're not around right now. But you can send us an email and we'll get back to you, asap.

Not readable? Change text. captcha txt