API

Аутентификация

Создайте персональный API-токен в Панель управления → API-токены. Передавайте его как bearer-заголовок в каждом запросе:

Authorization: Bearer <your-token>

Базовый URL

https://smsactivator.io

Endpoints

• GET/v1/servicesПолучить список поддерживаемых сервисов с текущими ценами по странам.
• GET/v1/countriesПолучить список стран с доступными номерами.
• POST/v1/ordersЗаказать виртуальный номер. Тело: { serviceSlug, countryIso }. Возвращает выделенный номер и orderId.
• GET/v1/orders/:idПроверить статус получения SMS. Возвращает { status, sms, expiresAt }.
• DELETE/v1/orders/:idОтменить активный заказ. Вернёт средства в кошелёк, если SMS ещё не получена.
• POST/v1/paymentsСоздать счёт для крипто-пополнения. Тело: { provider, amountUsd, cryptoCurrency? }. Возвращает payLink от OxaPay.
• GET/v1/walletПолучить текущий баланс кошелька и историю транзакций.
• GET/v1/rentalsПолучить список активных долгосрочных аренд.

Быстрый старт

curl -X POST https://smsactivator.io/v1/orders \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"serviceSlug":"telegram","countryIso":"US"}'

Rate limits

• • Размещение заказов: 30 запросов / минута / токен
• • Проверка статуса: 120 запросов / минута / токен
• • Пополнения: 10 запросов / час / токен
• • Глобальный лимит по IP: 120 запросов / минута (действует даже без токена)

При превышении лимита возвращается HTTP 429 с заголовком Retry-After.