Activations

Qu'est-ce qu'une activation ?

Une activation est la location courte d'un numéro pour un SMS-OTP. Vous la demandez, la plateforme réserve un numéro, vous lisez le code du SMS entrant, et l'activation se ferme — avec succès (facturée) ou expirée (gratuite).

Utilisez les activations quand vous n'avez besoin que d'un seul code (inscription, réinitialisation de mot de passe, KYC). Pour plusieurs SMS sur une fenêtre plus longue, voir Rentals.

Cycle de vie

waiting ─► sms_received ─► finished       (vous confirmez ; facturée)
   │                  └──► refunded       (pas de code ; gratuite)
   └─► expired                            (timeout ; gratuite)

• waiting — numéro réservé, pas encore de SMS.
• sms_received — au moins un SMS entrant capturé.
• finished — vous avez appelé finish ; facturée.
• expired — délai écoulé sans SMS ; non facturée.
• refunded — vous avez annulé avant confirmation ; non facturée.

Créer

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
  }'

Polling

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

Un polling toutes les 1,5–2 secondes convient ; le polling sub-seconde est limité. En production, les webhooks sont fortement recommandés.

Finish

Confirme l'activation et déclenche la facturation. Idempotent — appeler deux fois est sûr.

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

Cancel

Annule avant tout SMS. Retourne 409 si un SMS est déjà arrivé (appelez finish à la place).

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