📘 Документация для разработчиков

Получите свою первую SMS за 90 секунд

REST API, 4 типизированных SDK, подписанные webhook, ключи идемпотентности, выделенные пулы на Enterprise. Полный референс + рабочий код на вашем языке.

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

Три вызова — и готово

  1. 1
    Купите номер

    Выберите страну и сервис. Мы выдаём реальный номер из самого дешёвого работоспособного апстрим-пула.

    curl -X POST https://api.eveses.com/api/v1/numbers/orders \
      -H "Authorization: Bearer $KEY" \
      -d '{"country":"ua","mode":"activation","service":"telegram"}'
    
    # → 201 Created · 142ms
    # { "order_id":"ord_91f3a2b8", "phone":"+380635551822", "status":"waiting", "price_cents":7 }
  2. 2
    Дождитесь SMS · опрос или webhook

    Подпишитесь на webhook activation.sms_received или используйте опрос. p95 поступления SMS — 2.1 секунды.

    curl https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/sms \
      -H "Authorization: Bearer $KEY"
    
    # → 200 OK · 87ms
    # { "status":"sms_received", "sms":[{ "otp":"123456", "received_at":"..." }] }
  3. 3
    Завершите — средства списываются

    Пока вы не вызовете finish, средства остаются удержанными, а не списанными. В любой момент в окне можно отменить с полным возвратом.

    curl -X POST https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/finish \
      -H "Authorization: Bearer $KEY"
    
    # → 200 OK · 61ms
    # { "status":"finished", "charged_cents":7 }

Просмотрите документацию

С поиском, примерами на 4 языках и live-Try-it песочницей в каждом эндпоинте.

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

Первая SMS-верификация за 90 секунд — регистрация, API-ключ, получение кода.

⚡
Активации

SMS-верификации — жизненный цикл одного одноразового кода от запроса до списания.

🔑
Authentication

How to authenticate API requests with bearer tokens.

📞
Аренда

Удерживайте номер часами или днями — несколько SMS, история сообщений, автопродление при истечении.

🪝
Вебхуки

Получайте события активаций, аренды и кошелька как HTTPS-колбэки с HMAC-подписью.

💰
Кошелёк и пополнения

Баланс, пополнения, holds, возвраты и auto-recharge — как деньги движутся в Eveses.

🔑
Авторизация и API-ключи

Bearer-токены, ротация ключей, IP allowlist и ошибки что вы увидите при неудачной авторизации.

📦
SDK

Официальные клиентские библиотеки: PHP, JavaScript, Python, Go — установка, настройка и основные call sites.

🔁
Идемпотентность

Как заголовок `Idempotency-Key` защищает от двойного списания при ретраях на нестабильных сетях.

⚙
OpenAPI и Postman

Live OpenAPI spec, Scalar viewer, Postman коллекция — генерируйте клиентов, mock-серверы, что угодно.

📦 Типизированные SDK

4 языка · все сгенерированы из одной OpenAPI-спецификации · авто-повторы · типизированные ошибки.

JS@eveses/sdkPYEvesesGOevesescom/go-sdkPHPeveses/sdk
RBeveses-rb (soon)
RSeveses-rs (soon)
JVeveses-java (soon)

Готовы запускаться?

Первая активация за наш счёт · карта не нужна · возврат, если SMS не пришла.

⚡ Регистрация — начните строить
БЫТЬ В КУРСЕ

Новые гео, новые пулы, новые эндпоинты.

Почти каждую неделю добавляем страны, ротируем пулы и выкатываем изменения API. Оставьте почту — пришлём то, что важно: новое гео-покрытие, изменения ценовой лестницы и всё, что ломает интеграцию.

✓ Новые гео и продукты⚡ Ломающие изменения API🫥 Никакого спама

Отписаться можно в один клик. Email мы никому не передаём.