| 1. 전송경로 |
http://www.skysms.co.kr/apiSend/sendApi.php (charset이 EUC-KR일경우)
http://www.skysms.co.kr/apiSend/sendApi_UTF8.php (charset이 UTF-8일경우)
|
|
|
|
|
| 2. 전달값 (※) 필수입력값 |
| 전달변수 |
설명 |
| ※ authKey |
연동시 반드시 필요한 인증키 | 연동신청 후 발급받은 인증키 |
| ※ sUserid |
문자천국 회원아이디 | 회원가입시 회원님이 직접입력한 회원 아이디 |
| ※ sendMsg |
전송할 메세지 내용 | 짧은문자의경우 90bytes(한글45자,영문90자)
장문문자의경우 2000bytes(한글1000자,영문2000자)이내 발송가능 |
| ※ destNum |
받는분 핸드폰번호 | 대량전송의 경우 아래 3번 대량발송 및 수신자이름 자동입력을 확인하시기 바랍니다. |
| ※ callNum |
보내는분 전화번호 | 관공서,은행등의 특수한 번호는 사용할 수 없으며, 숫자만가능
2015년10월16일부터 인증된 전화번호만 이용가능 [발신번호등록하기] |
| ※ sMode |
실제발송과 테스트발송을 구분하는 변수 | 기본값:Test (Real:실제전송, Test:테스트전송) |
| sendDate |
발송시간 | 문자를 발송하는 시간. 값이 없거나, 이전의 시간의 경우 즉시발송
현재시간보다 이후의 시간입력시 예약발송 |
| returnURL |
전송완료 후 이동할 사이트URL | 결과코드, 전송완료건수, 실패건수 등을 받아볼 수 있습니다.
값이 없으면 현 페이지에 텍스트로 출력
결과코드 및 출력형식은 아래의 결과코드표를 참조 |
| customVal |
사용자정의 변수 | 변수를 사용하셔서 넘기시면 returnURL로 결과와 함께 전송 예)변수명^값|변수명^값 |
| sType |
짧은문자(sms)와 장문문자(lms)를 구분하는 변수 | 기본값:SMS (SMS:짧은문자, LMS:장문문자) |
| *sSubject |
장문문자의 제목 | sType의 값이 LMS일 경우만 사용 - 최대길이 한글20자이내 (Default:장문메세지) |
|
| 3. 대량발송 및 수신자이름 자동입력 |
대량발송
받는분 전화번호(destNum)값을 아래와 같이 "|"로 구분하여 입력
예제) <input type='hidden' name='destNum' value='01011111111|01011112222|01011113333'>
수신자이름 자동입력
받는분 전화번호(destNum)값을 아래와 같이 "휴대폰번호^이름"으로 입력하시고, 메세지내용(sendMsg)에 "(수신)"이라는 문구삽입후 전송.
예제) <input type='hidden' name='destNum' value='01011111111^홍길동1'>
대량발송일 경우 "휴대폰번호^이름|휴대폰번호^이름"으로 입력하시면 됩니다.
예제) <input type='hidden' name='destNum' value='01011111111^홍길동1|01011112222^홍길동2|01011113333^홍길동3'>
<input type='hidden' name='sendMsg' value='(수신)님 안녕하세요'>
|
|
| 4-1. 결과코드표 |
| 결과코드 |
설명 |
| 0000 |
전송성공 | 발송이 1건이상 성공한 경우 |
| 0088 |
인증키 오류 | 잘못된 인증키(authKey) 입력 |
| 0077 |
사용자인증 오류 | 인증키와 아이디입력시 해당회원이 없는 경우. 인증키와 아이디를 다시 확인해주세요 |
| 0011 |
보내는 분 전화번호 오류 | 관공서,은행등의 특수한 번호 및 잘못된 번호를 입력한 경우 |
| 0022 |
받는 분 휴대폰번호 오류 | 잘못된 핸드폰 번호로 전송건수가 없을경우 |
| 0033 |
발송(예약)시간오류 | 형식에 맞지않은 값을 입력할 경우 |
| 0044 |
잔액부족 | 전송건수에 해당하는 금액을 보유하지 못했을때 경우 |
| 0055 |
스팸이용자 | 기존 문자천국 전송시 스팸발송으로 인해 차단이 된 경우 |
| 0066 |
필수입력값 오류 | 아이디, 인증키, 받는분 핸드폰번호, 보내는분전화번호, 메세지내용 중 하나라도 값이 없는 경우 |
| 0099 |
발송IP차단 | 연동신청 시 발송IP 불일치 |
| 0555 |
발신번호 오류 | 인증되지 않은 발신번호 |
| 0556 |
발신번호 차단 | 차단된 발신번호 |
| 9999 |
기타오류 | 이외의 모든 오류일 경우( 담당자 또는 고객센터 문의 ) |
|
| 4-2. 출력형식 |
| returnURL 사용 |
returnURL?rCode=결과코드&rMsg=결과메세지&sendCount=성공건수&failCount=실패건수&uCount=남은건수&사용자임의변수1=값2&사용자임의변수2=값2등... 형식으로 returnURL 결과전송 |
| returnURL 미사용 |
결과코드|결과메세지|성공건수|실패건수|남은건수|사용자임의변수명^변수값|사용자임의변수명^변수값|... 형태로 출력 |
