| 1. 전송경로 |
| http://link.smsceo.co.kr/sendsms_euckr.php (charset 이 euc-kr일경우) |
| http://link.smsceo.co.kr/sendsms_utf8.php (charset 이 utf-8일경우) |
| 1.1 테스트 전송경로 |
| http://link.smsceo.co.kr/sendsms_test.php |
| 테스트 전송시 실제 과금은 이루어지지 않으며 결과 코드만 보실 수 있습니다. |
| 2. 전달값 |
|
|
| 3. 수신자 이름 자동입력 |
phone 값을 아래와 같이 "휴대폰번호^이름" 과 같이 '^'문자로 구분해서 입력하시고, msg값에 "[*이름*]" 이라는 문구를 입력 후
전송하시면 됩니다.
예)
...
<input type="type" name="phone" value="01012341234^홍길동|0113451234^김영희">
...
<input type="type" name="msg" value="[*이름*]님, 주문하신 물품이 배송처리되었습니다.">
|
| 4. 결과코드/설명 및 출력형식 |
| 4.1 결과코드/설명 |
| result_code |
result_msg |
| 1 |
성공 |
| 2 |
인증키 오류 |
| 3 |
userid에 해당하는 사용자 없음 |
| 4 |
받는사람 번호오류
(올바른 번호가 한건도 없을때 리턴되며, 여러건 중 한건이라도 전송성공일때 result_code는 1(성공)로 리턴됩니다.
성공건수, 실패건수는 succ_count, fail_count 변수를 참조하시면 됩니다.)
|
| 5 |
보내는사람 번호오류 |
| 6 |
예약시간 오류 |
| 7 |
잔액부족 |
| 8 |
기타오류 |
| 10 |
미등록된 회신번호 |
| 11 |
미등록 해외 IP |
| 12 |
장기 미사용 일시정지 - 고객센터 문의(070-8242-7200) |
|
|
| 4.2 출력형식 |
| return_url 지정시 |
return_url?result_code=결과코드&result_msg=결과메세지&total_count=총 접수건수&succ_count=성공건수&fail_count=실패건수&money=남은잔액 으로 리다이렉션 |
| return_url 미지정시 |
result_code=결과코드&result_msg=결과메세지&total_count=총 접수건수&succ_count=성공건수&fail_count=실패건수&money=남은잔액 을 출력 |
|
|
| 5. 연동예제 |
| 5.1 html 연동 방식 |
<form name="smsform" method="POST" action="http://link.smsceo.co.kr/sendsms_euckr.php">
<input type="hidden" name="userkey" value="인증키">
<input type="hidden" name="userid" value="문자대표 아이디">
<input type="hidden" name="msg" value="안녕하세요. 문자대표입니다.">
<input type="hidden" name="phone" value="01022223333">
<input type="hidden" name="callback" value="01022223333">
<input type="hidden" name="send_date" value="2011-01-11 00:00:00">
<input type="hidden" name="return_url" value="http://[고객님의 홈페이지 url]/result.htm">
<input type="hidden" name="return_var" value="">
</form>
<script>
document.smsform.submit();
</script>
form submit 방식은 소스보기로 인증키가 노출될 수 있으니, 관리자만 전송페이지를 볼 수 있도록 하시기 바랍니다.
|
|
| 5.2 php 연동 방식 |
<?
// php.ini 파일에서 allow_url_fopen 값이 On으로 되어있어야 합니다.
// return_url 변수와 return_var 변수는 사용되지 않습니다.
function sendsms($url)
{
$result = file_get_contents($url);
$result = trim($result);
parse_str($result, $result_var);
return $result_var;
}
$userkey = "인증키";
$userid = "문자대표 아이디";
$phone = "01122223333";
$callback = "01022223333";
$msg = urlencode("안녕하세요. 문자대표입니다.");
$send_date = urlencode("2011-01-11 00:00:00"); // 예약메세지일 경우 사용하시기 바랍니다.
// 아래 두 값은 사용되지 않습니다.
//$return_url = "";
//$return_var = "";
$url = "http://link.smsceo.co.kr/sendsms_euckr.php?userkey=" . $userkey;
$url .= "&userid=" . $userid;
$url .= "&phone=" . $phone;
$url .= "&callback=" . $callback;
$url .= "&msg=" . $msg;
$url .= "&send_date=" . $send_date;
$result = array();
$result = sendsms($url); // 결과 출력형식을 참고하세요.
// print_r($result);
if($result['result_code'] == "1") // 전송성공
{
echo "결과코드 : " . $result['result_code'];
echo "메세지 : " . $result['result_msg'];
echo "총 접수건수 : " . $result['total_count'];
echo "성공건수 : " . $result['succ_count'];
echo "실패건수 : " . $result['fail_count'];
echo "잔액 : " . $result['money'];
}
else
{
echo "결과코드 : " . $result['result_code'];
echo "메세지 : " . $result['result_msg'];
}
?>
|
|
| 5.3 asp 연동 방식 |
<%
Function SendSMS(url)
Dim result
Dim xmlHttp
Set xmlHttp = Server.CreateObject("Microsoft.XMLHTTP")
xmlHttp.open "GET", Xurl, False
xmlHttp.setRequestHeader "Content-Type","text/xml"
xmlHttp.setRequestHeader "Accept-Language","ko"
xmlHttp.send
If xmlHttp.status = 200 then
result = xmlHttp.responseText
Else
result = "fail"
End if
Set xmlHttp = Nothing
SendSMS = result
End Function
Dim userKey, userId, phone, callback, msg, sendDate, returnUrl, returnVar, result, url
userKey = "인증키"
userId = "문자대표 아이디"
phone = "01122223333"
callback = "01022223333"
msg = Server.URLEncode("안녕하세요. 문자대표입니다.")
sendDate = Server.URLEncode("2011-01-11 00:00:00") ' 예약메세지일 경우 사용하시기 바랍니다.
'아래 두 값은 사용되지 않습니다.
'returnUrl = ""
'returnVar = ""
url = "http://link.smsceo.co.kr/sendsms_euckr.php?userkey=" & userKey;
url = url & "&userid=" & userId;
url = url & "&phone=" & phone;
url = url & "&callback=" & callback;
url = url & "&msg=" & msg;
url = url & "&send_date=" & sendDate;
result = SendSMS(url)
Response.write result 결과 출력형식을 참고하세요.
%>
|