Перейти до змісту
tomnumber

API для SMS-верифікації

Купуйте номери й читайте коди з власної програми. API працює з вашим балансом, тими самими цінами і тим самим правилом повернення через 20 хвилин, що й сайт.

API-ключ створюється у вашому акаунті. Номери, куплені через API, оплачуються з того самого балансу за тими самими цінами, що й на сайті.

Створити акаунтAPI-ключ

Від $0.0018 за номер

Головне

Найнижча ціна за номер
$0.0018
Автентифікація
API-ключ
Формат
JSON через HTTPS
Ліміт запитів
120 запитів на хвилину
Повернення
Як на сайті

REST і JSON

Шість запитів: баланс, сервіси, ціни, отримання номера, статус і скасування.

Ключ з вашого акаунта

Створіть ключ на сторінці «API-ключ» в акаунті й передавайте його в заголовку Authorization.

Ціни як на сайті

Ціни на номери і правило повернення через 20 хвилин такі самі, як на сайті.

Які запити можна надсилати?

Шляхи додаються після базової URL-адреси. Кожен запит потребує вашого API-ключа.

Які запити можна надсилати?
Метод і шляхЩо робить
GET/balanceВаш баланс у USD
GET/servicesУсі сервіси з найнижчою ціною і кількістю країн
GET/prices?service=telegramЦіна одного номера для сервісу в кожній країні
POST/numbersОтримати номер для сервісу й країни; ціна списується з балансу
GET/numbers/{id}Статус номера і всі отримані коди
POST/numbers/{id}/cancelСкасувати до приходу коду; ціна повертається на баланс

У якому порядку викликати API?

  1. 1

    Отримайте номер POST /numbers із service і country. Збережіть id і номер.

  2. 2

    Введіть номер Введіть номер у сервісі, який надсилає код.

  3. 3

    Перевіряйте статус GET /numbers/{id} кожні 5 секунд, доки список codes не стане непорожнім.

  4. 4

    Завершіть Використайте код. Якщо номер більше не потрібен до приходу коду, скасуйте його.

Як отримати API-ключ?

Увійдіть і відкрийте розділ «API-ключ» в акаунті. Створіть ключ і одразу скопіюйте його: він показується лише один раз. Новий ключ вимикає старий.

API-ключ

Яка базова URL-адреса?

Надсилайте всі запити на цю адресу з ключем у заголовку Authorization (Bearer) або X-Api-Key:

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

Поля запиту

Поля запиту
ПолеДе використовуєтьсяЗначення
servicePOST /numbers, GET /pricesНазва сервісу з /services, наприклад telegram
countryPOST /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" }  ]}

Коди помилок

Коди помилок
unauthorizedAPI-ключ відсутній або неправильний
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"

API для SMS-верифікації: часті запитання

Що таке API для SMS-верифікації?

Спосіб купувати номери й читати коди з власної програми замість сайту.

Чи коштує API додатково?

Ні. Номери коштують стільки ж, скільки на сайті, і оплачуються з того самого балансу.

Скільки запитів можна надсилати?

До 120 запитів на хвилину на один ключ. Опитування кожні 5 секунд цілком укладається в цей ліміт.

Чи повертаються кошти за номери з API?

Так, за тим самим правилом: якщо коду немає протягом 20 хвилин, ціна повертається на баланс.

Де створити ключ?

В акаунті, у розділі «API-ключ».

Віртуальні номери для інших сервісів