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/
‘홍길동’ 씨는 아래와 같이 요청을 합니다.
위 예제에서 알 수 있듯이 ‘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 를 이용 시 쉽고 간편하게 문자메시지를 전송이 가능합니다.