Documentación·Activaciones
⚡

Activaciones

Verificaciones por SMS individuales — ciclo de vida de un código de un solo uso desde la solicitud hasta el cobro.

¿Qué es una activación?

Una activación es el alquiler corto de un número para un SMS-OTP. Lo solicitas, la plataforma reserva un número, lees el código del SMS entrante, y la activación se cierra — exitosamente (con cargo) o como expirada (gratis).

Usa activaciones cuando solo necesites un código (registro, restablecimiento de contraseña, KYC). Para varios SMS en una ventana mayor, mira Rentals.

Ciclo de vida

waiting ─► sms_received ─► finished       (confirmas; cobro)
   │                  └──► refunded       (sin código; gratis)
   └─► expired                            (timeout; gratis)
  • waiting — número reservado, sin SMS aún.
  • sms_received — al menos un SMS entrante capturado.
  • finished — llamaste a finish; con cargo.
  • expired — venció el plazo sin SMS; sin cargo.
  • refunded — cancelaste antes de confirmar; sin cargo.

Crear

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
  }'
Campo Obligatorio Notas
country sí Código ISO-2 de país
service sí Slug del catálogo de servicios o any
duration_minutes no 5 a 60. Default 20
max_price_cents no Amplía el pool de proveedores de failover hasta este límite

Polling

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

Polling cada 1,5–2 segundos está bien; polling sub-segundo está limitado. En producción se recomiendan webhooks.

Finish

Confirma la activación y dispara el cargo. Idempotente — llamar dos veces es seguro.

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

Cancel

Cancela antes de cualquier SMS. Devuelve 409 si ya llegó un SMS (entonces llama a finish).

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