Przejdź do treści
tomnumber

API do weryfikacji SMS

Kupuj numery i odczytuj kody z własnego oprogramowania. API korzysta z twojego salda, tych samych cen i tej samej zasady zwrotu po 20 minutach co strona.

Klucz API tworzysz na swoim koncie. Numery kupione przez API są opłacane z tego samego salda i w tych samych cenach co na stronie.

Załóż kontoKlucz API

Od $0.0018 za numer

Najważniejsze informacje

Najniższa cena za numer
$0.0018
Uwierzytelnianie
Klucz API
Format
JSON przez HTTPS
Limit zapytań
120 zapytań na minutę
Zwrot
Tak samo jak na stronie

REST i JSON

Sześć zapytań obejmuje saldo, serwisy, ceny, zakup numeru, status i anulowanie.

Klucz z twojego konta

Utwórz klucz w zakładce Klucz API na swoim koncie i wysyłaj go w nagłówku Authorization.

Te same ceny co na stronie

Ceny numerów i zasada zwrotu po 20 minutach są takie same jak na stronie.

Jakie zapytania mogę wysyłać?

Ścieżki dopisujesz do bazowego URL. Każde zapytanie wymaga klucza API.

Jakie zapytania mogę wysyłać?
Metoda i ścieżkaCo robi
GET/balanceTwoje saldo w USD
GET/servicesWszystkie serwisy z najniższą ceną i liczbą krajów
GET/prices?service=telegramCena jednego numeru do danego serwisu w każdym kraju
POST/numbersKupuje numer dla serwisu i kraju; cena jest pobierana z salda
GET/numbers/{id}Status numeru i wszystkie dotychczas odebrane kody
POST/numbers/{id}/cancelAnulowanie przed otrzymaniem kodu; kwota wraca na saldo

W jakiej kolejności wywoływać API?

  1. 1

    Kup numer POST /numbers z polami service i country. Zapisz id i numer.

  2. 2

    Wpisz numer Wpisz numer w serwisie, który wysyła kod.

  3. 3

    Sprawdzaj kod GET /numbers/{id} co 5 sekund, aż lista codes nie będzie pusta.

  4. 4

    Zakończ Użyj kodu. Jeśli przed otrzymaniem kodu numer nie jest już potrzebny, anuluj go.

Jak zdobyć klucz API?

Zaloguj się i otwórz zakładkę Klucz API na swoim koncie. Utwórz klucz i od razu go skopiuj; jest pokazywany tylko raz. Nowy klucz wyłącza poprzedni.

Klucz API

Jaki jest bazowy URL?

Wysyłaj każde zapytanie na ten adres, z kluczem w nagłówku Authorization (Bearer) lub X-Api-Key:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

Pola zapytania

Pola zapytania
PoleGdzieWartość
servicePOST /numbers, GET /pricesNazwa serwisu z /services, np. telegram
countryPOST /numbersDwuliterowy kod kraju, np. gb

Pola odpowiedzi i statusy

Pola odpowiedzi i statusy
WartośćZnaczenie
waitingNumer jest aktywny, kod jeszcze nie przyszedł
receivedPrzyszedł co najmniej jeden kod; kolejne mogą przychodzić do expires_at
refundedBrak kodu w ciągu 20 minut; kwota wróciła na saldo
canceledAnulowano przed otrzymaniem kodu; kwota wróciła na saldo

Przykładowa odpowiedź

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

Kody błędów

Kody błędów
unauthorizedBrak klucza API lub błędny klucz
rate_limitedPonad 120 zapytań w ciągu minuty
bad_serviceNieznana nazwa serwisu
bad_countryKraj niedostępny dla tego serwisu
low_balanceSaldo jest niższe niż cena
unavailableBrak dostępnego numeru w tej chwili. Nic nie zostało pobrane
not_foundNa twoim koncie nie ma numeru o tym id
cannot_cancelKod już przyszedł albo numer jest zamknięty

Przykłady kodu

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

API do weryfikacji SMS: FAQ

Czym jest API do weryfikacji SMS?

To sposób na kupowanie numerów i odczyt kodów z własnego programu zamiast przez stronę.

Czy API kosztuje dodatkowo?

Nie. Numery kosztują tyle samo co na stronie i są opłacane z tego samego salda.

Ile zapytań mogę wysłać?

Do 120 zapytań na minutę na klucz. Sprawdzanie co 5 sekund mieści się w tym z dużym zapasem.

Czy numery z API też są zwracane?

Tak, na tej samej zasadzie: brak kodu w ciągu 20 minut oznacza zwrot kwoty na saldo.

Gdzie utworzyć klucz?

Na swoim koncie, w zakładce Klucz API.

Wirtualne numery do innych serwisów