TODAY SMS

JSON · HTTPS · klucz Bearer

Odbieraj kody weryfikacyjne i wysyłaj SMS przez jedno SMS API

API TODAY SMS to API dla programistów, które łączy API weryfikacji SMS do odbierania kodów na numery jednorazowe i API wysyłki SMS do 227 krajów, z jednym kluczem API i jednym saldem. Każde zapytanie i odpowiedź są w JSON, a ceny i zasady zwrotów są takie same jak na stronie.

Zobacz dokumentację APIZałóż konto i odbierz klucz
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 zapytań na minutę
  • Jeden klucz do odbioru i wysyłki
  • Zwrot na saldo za nieudane i nieodebrane
  • Doładuj 12 metodami kryptowalutowymi

Co możesz zrobić z SMS API

API weryfikacji SMS

Wybierz aplikację i kraj, kup numer i odpytuj jego status, aby odebrać kod weryfikacyjny. Jeśli SMS nie przyjdzie, po upływie czasu cała kwota wraca na saldo.

API wysyłki SMS

Wyślij wiadomość naraz do 1000 odbiorców i otrzymaj raport doręczenia dla każdego z nich. Dodaj zaplanowany czas, aby wysłać ją wtedy.

API cen i dostępności

Pobieraj przez API kraje i ceny dla aplikacji, liczbę numerów i cenę za SMS dla każdego kraju i pokazuj je bez zmian we własnej usłudze.

Jedno saldo

Odbiór i wysyłka korzystają z tego samego salda. Doładuj je w USDT i sprawdzaj w dowolnej chwili przez API.

Metody w skrócie

MetodaCo robi
GET/balancePobierz saldo
GET/appsLista aplikacji
GET/prices?app=telegramKraje i ceny dla aplikacji
POST/numbersKup numer
GET/numbers/{id}Status numeru i SMS
POST/numbers/{id}/cancelAnuluj numer
POST/numbers/{id}/finishZakończ numer
GET/messages/pricesCeny SMS według kraju
POST/messagesWyślij SMS
GET/messages/{id}Status wysyłki i raporty doręczenia
POST/messages/{id}/cancelAnuluj zaplanowaną wysyłkę

Czym jest SMS API?

SMS API to połączenie, dzięki któremu Twój program odbiera lub wysyła SMS za pomocą zapytań HTTP. Kod robi to, co człowiek klikałby na stronie, więc powtarzalne zadania, takie jak automatyczne testy rejestracji, wysyłka kodów weryfikacyjnych i powiadomień o zamówieniach, działają bez niczyjej pracy.

API TODAY SMS oferuje dwie rzeczy naraz. Pierwsza to API weryfikacji SMS (SMS activation API) do odbierania kodów weryfikacyjnych aplikacji na numery jednorazowe, a druga to API wysyłki SMS na telefony komórkowe na całym świecie. Oba korzystają z tego samego adresu, tego samego klucza API i tego samego salda, więc nie ma osobnej rejestracji ani doładowania.

Jak korzystać z API weryfikacji SMS?

To cztery kroki. Wybierz kod aplikacji przez GET /apps i sprawdź kraje i ceny przez GET /prices?app=CODE. Kup numer przez POST /numbers, aby otrzymać numer i jego id, a potem co kilka sekund wywołuj GET /numbers/{id}, aby sprawdzić, czy kod dotarł. Gdy masz kod, zamknij numer przez POST /numbers/{id}/finish.

Każdy numer czeka na SMS przez 20 min, a SMS na ten sam numer w tym czasie nic dodatkowo nie kosztują. Jeśli SMS nie przyjdzie, po upływie czasu cała kwota wraca na saldo, a jeśli nic nie dotarło, możesz sam anulować numer przez POST /numbers/{id}/cancel po 120 s od zakupu. Gdy potrzebujesz automatyzacji weryfikacji aplikacji lub API wirtualnych numerów na dużą skalę, po prostu powtarzaj ten proces.

Jak korzystać z API wysyłki SMS?

Wyślij listę odbiorców (to) i treść wiadomości (text) do POST /messages, a otrzymasz id wiadomości, liczbę odbiorców, liczbę części i łączny koszt. Odbiorców podawaj w formacie międzynarodowym z + i numerem kierunkowym, do 1000 na zapytanie. Aby zaplanować wysyłkę, podaj czas UTC w polu at.

Po wysyłce sprawdzaj raport doręczenia dla każdego odbiorcy przez GET /messages/{id}. Są cztery statusy: pending, sent, delivered i failed, a kwota za części zakończone statusem failed jest dodawana do refunded i wraca na saldo. Zaplanowaną wysyłkę, która jeszcze nie ruszyła, anulujesz przez POST /messages/{id}/cancel.

Tej samej metody użyjesz do wysyłki kodów weryfikacyjnych (OTP). Każdy kod liczy się jako jeden SMS bez osobnej opłaty za weryfikację, a cenę za SMS dla każdego kraju pobierzesz przez GET /messages/prices, aby policzyć koszty.

Na co zwrócić uwagę, wybierając tanie SMS API?

Patrz na łączną kwotę, którą faktycznie płacisz, a nie tylko na cenę za SMS w cenniku. TODAY SMS nie pobiera opłaty miesięcznej i nalicza tylko wysłane części, a za nieudane części i kody weryfikacyjne, które nie dotarły, dostajesz zwrot na saldo.

Następnie przyjrzyj się zarządzaniu kluczami i limitom. Otrzymujesz jeden klucz API na konto i możesz utworzyć nowy w dowolnym momencie, co natychmiast blokuje stary klucz. Żądania są dozwolone do 300 na minutę, co wystarcza dla większości automatyzacji. Na koniec przyjrzyj się płatnościom. Możesz doładować konto 12 metodami kryptowalutowymi, w tym USDT, USDC i BTC bez karty, dzięki czemu możesz rozpocząć od razu z dowolnego kraju.

Jak otrzymać klucz API?

Załóż konto, a gdy pierwsze doładowanie trafi na saldo, utworzysz klucz na stronie kluczy API. Klucz pokazujemy tylko raz, przy tworzeniu, więc zapisz go w bezpiecznym miejscu. Wysyłaj go w każdym zapytaniu w nagłówku Authorization: Bearer.

Jeśli podejrzewasz, że klucz wyciekł, utwórz nowy na stronie kluczy API. Stary klucz od razu przestanie działać. Każdy, kto ma Twój klucz, może kupować numery lub wysyłać SMS z Twojego salda, więc nigdy nie umieszczaj go w kodzie przeglądarki ani w publicznym repozytorium.

Podłącz SMS API już dziś

Rejestracja to tylko jeden token. Gdy pierwsze doładowanie trafi na saldo, utwórz klucz API, wklej przykład z dokumentacji i wyślij pierwsze zapytanie.

Zobacz dokumentację APIZałóż konto i odbierz klucz