- Главная
- 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-ключ.