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.
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.
| Metoda i ścieżka | Co robi |
|---|---|
GET/ | Twoje saldo w USD |
GET/ | Wszystkie serwisy z najniższą ceną i liczbą krajów |
GET/ | Cena jednego numeru do danego serwisu w każdym kraju |
POST/ | Kupuje numer dla serwisu i kraju; cena jest pobierana z salda |
GET/ | Status numeru i wszystkie dotychczas odebrane kody |
POST/ | Anulowanie przed otrzymaniem kodu; kwota wraca na saldo |
W jakiej kolejności wywoływać API?
- 1
Kup numer POST /numbers z polami service i country. Zapisz id i numer.
- 2
Wpisz numer Wpisz numer w serwisie, który wysyła kod.
- 3
Sprawdzaj kod GET /numbers/{id} co 5 sekund, aż lista codes nie będzie pusta.
- 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 APIJaki 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/v1Authorization: Bearer <API_KEY>Pola zapytania
| Pole | Gdzie | Wartość |
|---|---|---|
service | POST /numbers, GET /prices | Nazwa serwisu z /services, np. telegram |
country | POST /numbers | Dwuliterowy kod kraju, np. gb |
Pola odpowiedzi i statusy
| Wartość | Znaczenie |
|---|---|
waiting | Numer jest aktywny, kod jeszcze nie przyszedł |
received | Przyszedł co najmniej jeden kod; kolejne mogą przychodzić do expires_at |
refunded | Brak kodu w ciągu 20 minut; kwota wróciła na saldo |
canceled | Anulowano 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
unauthorized | Brak klucza API lub błędny klucz |
rate_limited | Ponad 120 zapytań w ciągu minuty |
bad_service | Nieznana nazwa serwisu |
bad_country | Kraj niedostępny dla tego serwisu |
low_balance | Saldo jest niższe niż cena |
unavailable | Brak dostępnego numeru w tej chwili. Nic nie zostało pobrane |
not_found | Na twoim koncie nie ma numeru o tym id |
cannot_cancel | Kod 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"const api = (path, init = {}) => fetch("https://tomnumber.com/api/v1" + path, { ...init, headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" }, }).then((r) => r.json()); const n = await api("/numbers", { method: "POST", body: JSON.stringify({ service: "telegram", country: "gb" }) });console.log(n.number); // enter this number in the app let codes = [];while (!codes.length) { await new Promise((r) => setTimeout(r, 5000)); const s = await api("/numbers/" + n.id); if (s.status === "refunded" || s.status === "canceled") break; codes = s.codes;}console.log(codes.map((c) => c.code));import os, time, requests API = "https://tomnumber.com/api/v1"H = {"Authorization": "Bearer " + os.environ["API_KEY"]} n = requests.post(API + "/numbers", json={"service": "telegram", "country": "gb"}, headers=H).json()print(n["number"]) # enter this number in the app while True: time.sleep(5) s = requests.get(API + "/numbers/" + n["id"], headers=H).json() if s["codes"] or s["status"] in ("refunded", "canceled"): breakprint([c["code"] for c in s["codes"]])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.