>otpfactory.io

API

REST API для заказа виртуальных номеров, получения SMS, управления арендой и пополнения кошелька. Те же endpoints, что используются в панели управления — bearer-token аутентификация, JSON в/из, SDK не требуется.

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

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

Authorization: Bearer <your-token>

Базовый URL

https://api.otpfactory.com

Endpoints

  • GET/v1/servicesПолучить список поддерживаемых сервисов с текущими ценами по странам.
  • GET/v1/countriesПолучить список стран с доступными номерами.
  • POST/v1/ordersapiPage.endpoints.items.createOrder
  • GET/v1/orders/:idapiPage.endpoints.items.getOrder
  • DELETE/v1/orders/:idОтменить активный заказ. Вернёт средства в кошелёк, если SMS ещё не получена.
  • POST/v1/paymentsapiPage.endpoints.items.createPayment
  • GET/v1/walletПолучить текущий баланс кошелька и историю транзакций.
  • GET/v1/rentalsПолучить список активных долгосрочных аренд.

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

curl -X POST https://api.otpfactory.com/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.

Нужен более высокий лимит?

Свяжитесь с нами @otpfactory_support и опишите свой сценарий использования. Партнёры и интеграторы получают 10-кратный буст лимита на endpoints заказов.