- Головна
- API
API для SMS-верифікації
Купуйте номери й читайте коди з власної програми. API працює з вашим балансом, тими самими цінами і тим самим правилом повернення через 20 хвилин, що й сайт.
API-ключ створюється у вашому акаунті. Номери, куплені через API, оплачуються з того самого балансу за тими самими цінами, що й на сайті.
Головне
- Найнижча ціна за номер
- $0.0018
- Автентифікація
- API-ключ
- Формат
- JSON через HTTPS
- Ліміт запитів
- 120 запитів на хвилину
- Повернення
- Як на сайті
REST і JSON
Шість запитів: баланс, сервіси, ціни, отримання номера, статус і скасування.
Ключ з вашого акаунта
Створіть ключ на сторінці «API-ключ» в акаунті й передавайте його в заголовку Authorization.
Ціни як на сайті
Ціни на номери і правило повернення через 20 хвилин такі самі, як на сайті.
Які запити можна надсилати?
Шляхи додаються після базової URL-адреси. Кожен запит потребує вашого API-ключа.
| Метод і шлях | Що робить |
|---|---|
GET/ | Ваш баланс у USD |
GET/ | Усі сервіси з найнижчою ціною і кількістю країн |
GET/ | Ціна одного номера для сервісу в кожній країні |
POST/ | Отримати номер для сервісу й країни; ціна списується з балансу |
GET/ | Статус номера і всі отримані коди |
POST/ | Скасувати до приходу коду; ціна повертається на баланс |
У якому порядку викликати API?
- 1
Отримайте номер POST /numbers із service і country. Збережіть id і номер.
- 2
Введіть номер Введіть номер у сервісі, який надсилає код.
- 3
Перевіряйте статус GET /numbers/{id} кожні 5 секунд, доки список codes не стане непорожнім.
- 4
Завершіть Використайте код. Якщо номер більше не потрібен до приходу коду, скасуйте його.
Як отримати API-ключ?
Увійдіть і відкрийте розділ «API-ключ» в акаунті. Створіть ключ і одразу скопіюйте його: він показується лише один раз. Новий ключ вимикає старий.
API-ключЯка базова URL-адреса?
Надсилайте всі запити на цю адресу з ключем у заголовку Authorization (Bearer) або X-Api-Key:
https://tomnumber.com/api/v1Authorization: Bearer <API_KEY>Поля запиту
| Поле | Де використовується | Значення |
|---|---|---|
service | POST /numbers, GET /prices | Назва сервісу з /services, наприклад telegram |
country | POST /numbers | Дволітерний код країни, наприклад gb |
Поля відповіді та статуси
| Значення | Що означає |
|---|---|
waiting | Номер відкритий, код ще не прийшов |
received | Прийшов щонайменше один код; нові можуть надходити до expires_at |
refunded | Коду не було протягом 20 хвилин; ціну повернено на баланс |
canceled | Ви скасували номер до приходу коду; ціну повернено на баланс |
Приклад відповіді
{ "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" } ]}Коди помилок
unauthorized | API-ключ відсутній або неправильний |
rate_limited | Понад 120 запитів за хвилину |
bad_service | Невідома назва сервісу |
bad_country | Країна недоступна для цього сервісу |
low_balance | Баланс менший за ціну |
unavailable | Зараз немає вільних номерів. Кошти не списано |
not_found | У вашому акаунті немає номера з таким id |
cannot_cancel | Код уже прийшов або номер закрито |
Приклади коду
# 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 для SMS-верифікації: часті запитання
Що таке API для SMS-верифікації?
Спосіб купувати номери й читати коди з власної програми замість сайту.
Чи коштує API додатково?
Ні. Номери коштують стільки ж, скільки на сайті, і оплачуються з того самого балансу.
Скільки запитів можна надсилати?
До 120 запитів на хвилину на один ключ. Опитування кожні 5 секунд цілком укладається в цей ліміт.
Чи повертаються кошти за номери з API?
Так, за тим самим правилом: якщо коду немає протягом 20 хвилин, ціна повертається на баланс.
Де створити ключ?
В акаунті, у розділі «API-ключ».