Документація·Активації
⚡

Активації

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

Що таке активація

Активація — це короткострокова оренда номеру для одного SMS-OTP. Ви робите запит, платформа резервує номер, ви читаєте код із SMS, і активація закривається — або успішно (списання) або як expired (безкоштовно).

Використовуйте активації коли потрібен один код (реєстрація, скидання пароля, KYC). Для багатьох SMS у довшому вікні — див. Rentals.

Життєвий цикл

waiting ─► sms_received ─► finished       (ви підтверджуєте; списання)
   │                  └──► refunded       (немає коду; безкоштовно)
   └─► expired                            (таймаут; безкоштовно)
  • waiting — номер зарезервований, SMS ще немає.
  • sms_received — захоплено хоча б одне вхідне SMS.
  • finished — ви викликали finish; списано.
  • expired — час вийшов без SMS; не списано.
  • refunded — ви скасували до підтвердження; не списано.

Створення

curl -X POST https://api.eveses.com/v1/activations \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "country": "ua",
    "service": "telegram",
    "duration_minutes": 15,
    "max_price_cents": 12
  }'
Поле Обов'язкове Опис
country так Код країни ISO-2
service так Слаг із каталогу сервісів або any
duration_minutes ні Від 5 до 60. Default 20
max_price_cents ні Розширює failover-пул до будь-яких провайдерів ≤ ліміту

Опитування

curl https://api.eveses.com/v1/activations/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e \
  -H "Authorization: Bearer $EVESES_API_KEY"

Опитування з інтервалом 1.5–2 с нормально; sub-second опитування лімітується. У продакшні рекомендуються вебхуки.

Завершення

Підтверджує активацію та запускає списання. Ідемпотентно — викликати двічі безпечно.

curl -X POST https://api.eveses.com/v1/activations/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e/finish \
  -H "Authorization: Bearer $EVESES_API_KEY"

Скасування

Скасовує до доставки SMS. Повертає 409 якщо SMS вже прийшла (тоді викликайте finish).

curl -X POST https://api.eveses.com/v1/activations/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e/cancel \
  -H "Authorization: Bearer $EVESES_API_KEY"
← ПопередняШвидкий стартНаступна →Authentication