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

Отримайте перше SMS за 90 секунд

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

Quickstart

Три виклики — і готово

  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 · poll або webhook

    Підпишіться на webhook activation.sms_received або робіть polling. 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 мовами та живою Try-it пісочницею у кожному ендпойнті.

🚀
Швидкий старт

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

⚡
Активації

Верифікації одного SMS — життєвий цикл одноразового коду від запиту до списання.

🔑
Authentication

How to authenticate API requests with bearer tokens.

📞
Оренда

Тримайте номер годинами або днями — кілька SMS, історія повідомлень, автопродовження при завершенні.

🪝
Вебхуки

Отримуйте події активацій, оренди та гаманця як HTTPS-колбеки з HMAC-підписом.

💰
Гаманець та поповнення

Баланс, поповнення, holds, refund'и та 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.