TODAY SMS

JSON · HTTPS · Bearer 키

SMS API로 인증번호 받기와 문자 보내기를 한 번에

TODAY SMS API는 일회용 번호로 인증번호를 받는 문자 인증 API와 227개 나라로 문자를 보내는 문자 보내기 API를 한 API 키, 한 크레딧으로 쓰는 개발자용 API예요. 요청과 응답은 모두 JSON이고, 가격과 환불 규칙은 웹사이트와 같아요.

API 문서 보기가입하고 키 받기
today-sms.com/api/v1
$ curl -X POST https://today-sms.com/api/v1/numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app":"telegram","country":"indonesia"}'
{
  "id": "N-7K2M-QX4P-9D3A",
  "phone": "+6281234567890",
  "price": "0.4515",
  "status": "waiting",
  "expires_at": "2026-10-18T09:20:00.000Z"
}

$ curl https://today-sms.com/api/v1/numbers/N-7K2M-QX4P-9D3A \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "id": "N-7K2M-QX4P-9D3A",
  "status": "received",
  "sms": [
    { "code": "482913", "text": "Your code is 482913", "at": "2026-10-18T09:02:11.000Z" }
  ]
}
  • 분당 300회
  • 받기 · 보내기 같은 키
  • 실패 · 미수신 크레딧 환불
  • 암호화폐 12가지로 충전

SMS API로 할 수 있는 것

문자 인증 API

앱과 나라를 골라 번호를 사고, 상태를 물어 인증번호를 받아요. 문자가 오지 않으면 시간이 끝날 때 전액이 크레딧으로 돌아가요.

문자 보내기 API

받는 사람 최대 1,000명과 문구를 한 번에 보내고, 받는 사람별 도착 보고를 받아요. 예약 시각을 넣으면 그때 보내요.

가격과 재고 API

앱별 나라와 가격, 번호 수, 나라별 문자 한 통 가격을 API로 받아 내 서비스 화면에 그대로 쓸 수 있어요.

크레딧 하나

받기와 보내기가 같은 크레딧을 써요. 크레딧은 USDT로 충전하고, API로 언제든 확인해요.

메서드 한눈에 보기

메서드하는 일
GET/balance크레딧 확인
GET/apps앱 목록
GET/prices?app=telegram앱별 나라와 가격
POST/numbers번호 구매
GET/numbers/{id}번호 상태와 문자
POST/numbers/{id}/cancel번호 취소
POST/numbers/{id}/finish번호 끝내기
GET/messages/prices나라별 문자 가격
POST/messages문자 보내기
GET/messages/{id}발송 상태와 도착 보고
POST/messages/{id}/cancel예약 발송 취소

SMS API란 무엇인가요?

SMS API는 내 프로그램이 HTTP 요청으로 문자를 받거나 보내게 해 주는 연결 창구예요. 사람이 웹 화면에서 누르던 일을 코드가 대신해서, 가입 시험 자동화, 인증 코드 발송, 주문 알림처럼 반복되는 일을 사람 손 없이 처리할 수 있어요.

TODAY SMS API는 두 가지를 함께 제공해요. 하나는 일회용 번호로 앱 인증번호를 받는 문자 인증 API(SMS activation API)이고, 다른 하나는 전 세계 휴대폰으로 문자를 보내는 문자 보내기 API예요. 두 API는 같은 주소, 같은 API 키, 같은 크레딧을 써서 따로 가입하거나 따로 충전할 필요가 없어요.

문자 인증 API는 어떻게 쓰나요?

순서는 네 단계예요. GET /apps로 앱 코드를 고르고, GET /prices?app=CODE로 나라와 가격을 봐요. POST /numbers로 번호를 사면 번호와 id가 돌아오고, GET /numbers/{id}를 몇 초마다 불러 인증번호가 왔는지 확인해요. 코드를 받으면 POST /numbers/{id}/finish로 닫아요.

번호는 20분 동안 문자를 기다리고, 그 안에 같은 번호로 오는 문자는 추가 비용이 없어요. 문자가 오지 않으면 시간이 끝날 때 전액이 크레딧으로 돌아가고, 아무것도 오지 않았다면 구매 120초 뒤부터 POST /numbers/{id}/cancel로 직접 취소할 수 있어요. 앱 인증 자동화나 대량 가상 번호 API가 필요할 때 이 흐름을 그대로 반복하면 돼요.

문자 보내기 API는 어떻게 쓰나요?

POST /messages에 받는 사람 목록(to)과 문구(text)를 보내면 메시지 id, 받는 사람 수, 통 수, 총비용이 돌아와요. 받는 사람은 + 와 국번이 붙은 국제 형식으로 넣고, 한 요청에 최대 1,000명까지 넣을 수 있어요. 예약하려면 at에 UTC 시각을 넣어요.

보낸 뒤에는 GET /messages/{id}로 받는 사람별 도착 보고를 확인해요. 상태는 pending, sent, delivered, failed 네 가지이고, failed로 끝난 통은 금액이 refunded에 더해져 크레딧으로 돌아가요. 아직 보내지 않은 예약 발송은 POST /messages/{id}/cancel로 취소해요.

인증 코드(OTP)를 보낼 때도 같은 메서드를 써요. 코드 한 건이 한 통으로 계산되어 별도 인증 요금이 없고, 나라별 한 통 가격은 GET /messages/prices로 받아 내 비용 계산에 쓸 수 있어요.

싼 SMS API를 고르려면 무엇을 봐야 하나요?

가격표의 한 통 가격과 함께 실제로 내는 총액을 보세요. TODAY SMS는 월 요금 없이 보낸 통 수만큼만 빠지고, 실패한 통과 받지 못한 인증번호는 크레딧으로 돌려드려요.

다음으로 키 관리와 제한을 보세요. API 키는 계정마다 하나이고 언제든 새로 만들 수 있어요. 새로 만들면 이전 키는 바로 막혀요. 요청은 1분에 300회까지라 대부분의 자동화에 넉넉해요. 마지막으로 결제 방법을 보세요. 카드 없이 USDT, USDC, BTC 등 암호화폐 12가지로 충전할 수 있어서 나라와 관계없이 바로 시작할 수 있어요.

API 키는 어떻게 받나요?

계정을 만들고 첫 충전이 반영되면 API 키 페이지에서 키를 만들 수 있어요. 키는 만들 때 한 번만 보여 드리니 안전한 곳에 저장해 주세요. 요청마다 Authorization: Bearer 키 머리글로 보내면 돼요.

키가 새어 나갔다고 생각되면 API 키 페이지에서 새 키를 만들어 주세요. 이전 키는 바로 쓸 수 없게 돼요. 키를 가진 사람은 내 크레딧으로 번호를 사거나 문자를 보낼 수 있으니 브라우저 코드나 공개 저장소에 넣지 마세요.

지금 SMS API를 연결해 보세요

가입은 토큰 하나면 끝나요. 첫 충전이 반영되면 API 키를 만들고, 문서의 예제를 그대로 붙여 넣어 첫 요청을 보내 보세요.

API 문서 보기가입하고 키 받기