HTTP API

 

호출 URL

http://api.coolsms.co.kr/sendmsg  (일반) https://api.coolsms.co.kr/sendmsg  (보안) GET 혹은 POST 방식으로 호출 URL으로 던져주면 문자메시지가 발송됩니다.  

폼데이터 키/값

 

필수 Key Value
O user 아이디
O password 비밀번호
  enc 인코딩된 비밀번호의 암호화 알고리즘(현재 MD5만 지원)
O to 수신번호
O from 발신번호
O text 문자내용
  type SMS(90바이트), LMS(장문 2,000바이트), MMS(장문+이미지)  입력 없으면 SMS가 기본 국가코드가 KR이 아니면 SMS로 강제
  image POST로 전달 지원형식 : 200KB 이하의 JPEG
  refname 참조내용(이름)
  country 국가코드 (한국: KR, 일본: JP, 미국: US, 중국: CN)  입력 없으면 KR이 기본
  datetime 예약시간 (YYYMMDDHHMISS 포맷으로 입력)  입력 없으면 바로 전송
  mid 사용자 메시지ID 지정  입력 없으면 게이트웨이 서버에서 생성
  gid 사용자 그룹ID 지정  입력 없으면 게이트웨이 서버에서 생성
  subject LMS, MMS 일때 제목 (40바이트)
  charset 한글 인코딩 방식 지정  유니코드 UTF-8 일 경우 utf8 완성형 한글(EUC-KR) 일 경우 euckr 으로 입력 입력 없으면 utf8가 기본

 

결과리턴

URL호출 후 ‘\n’ (NEW LINE) 으로 구분된 문자열이 리턴됩니다. Key/Value는 ‘=’으로 구분합니다.  

Key Value
CALLED-NUMBER 수신번호
GROUP-ID 메시지 그룹아이디
MESSAGE-ID 메시지 아이디
RESULT-CODE 접수결과 코드
RESULT-MESSAGE 접수결과 메시지

  1. 성공했을 때 예 CALLED-NUMBER=01000000000 GROUP-ID=20120217104104452761276752 MESSAGE-ID=20120217104104536880116376 RESULT-CODE=00 RESULT-MESSAGE=Success VERSION=TBSP/1.0   2. 실패했을 때 예 CALLED-NUMBER=01000000000 GROUP-ID=20120217103829612403761364 MESSAGE-ID=20120217103830163531890062 RESULT-CODE=20 RESULT-MESSAGE=User Not Found VERSION=TBSP/1.0 오류코드표 보기

예제

1. 일반적으로 아래와 같이 URL을 호출하면 HELLO라는 문자내용이 to에 입력된01000000000번의 휴대전화로 전송됩니다.

http://api.coolsms.co.kr/sendmsg?user=USERID&password=PASSWORD&to=01000000000&from=0200000000&text=HELLO

  2. 비밀번호를 암호화 할 경우 password에 MD5로 암호화된 문자열을 입력하고 enc값에 MD5를 입력해 줍니다.

http://api.coolsms.co.kr/sendmsg?user=USERID&password= 319f4d26e3c536b5dd871bb2c52e3178&enc=MD5&to=01000000000&from=0200000000&text=HELLO

HTML 예제 코드 smstest.zip

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="ko" xml:lang="ko" xmlns="http://www.w3.org/1999/xhtml">
	<head>
    	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	</head>
	<body>
		<form method="post" action="http://api.coolsms.co.kr/sendmsg" enctype="multipart/form-data">
			<ul>
				<li>User Id: <input type="text" name="user" value="" /></li>
				<li>Password: <input type="text" name="password" value="" /></li>
				<li>To: <input type="text" name="to" value="" /></li>
				<li>From: <input type="text" name="from" value="" /></li>
				<li>Subject: <input type="text" name="subject" value="" /></li>
				<li>Text: <input type="text" name="text" value="" /></li>
				<li>Type: <select name="type">
					<option value="SMS">SMS</option>
					<option value="LMS">LMS</option>
					<option value="MMS">MMS</option>
				</select></li>
				<li>Image: <input type="file" name="image" /></li>
				<li>input type="submit" value="Submit" /></li>
			</ul>
		</form>
	</body>
</html>