Активации

Что такое активация

Активация — это краткосрочная аренда номера под одно 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
  }'

Опрос

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

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

Finish

Подтверждает активацию и запускает списание. Идемпотентно — вызвать дважды безопасно.

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

Cancel

Отменяет до доставки 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"