⚡

Ativações

Verificações por SMS unitárias — ciclo de vida de um código de uso único da solicitação à cobrança.

O que é uma ativação?

Uma ativação é o aluguel curto de um número para um SMS-OTP. Você solicita, a plataforma reserva o número, lê o código do SMS recebido, e a ativação fecha — com sucesso (cobrada) ou como expirada (grátis).

Use ativações quando precisar apenas de um código (cadastro, redefinição de senha, KYC). Para múltiplos SMS em uma janela mais longa, veja Rentals.

Ciclo de vida

waiting ─► sms_received ─► finished       (você confirma; cobrada)
   │                  └──► refunded       (sem código; grátis)
   └─► expired                            (timeout; grátis)

waiting — número reservado, sem SMS ainda.
sms_received — pelo menos um SMS recebido capturado.
finished — você chamou finish; cobrada.
expired — prazo expirou sem SMS; sem cobrança.
refunded — você cancelou antes de confirmar; sem cobrança.

Criar

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	Obrigatório	Notas
`country`	sim	Código ISO-2 do país
`service`	sim	Slug do catálogo de serviços ou `any`
`duration_minutes`	não	5 a 60. Default 20
`max_price_cents`	não	Amplia o pool de provedores de failover até esse teto

Polling

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

Polling a cada 1,5–2 segundos é ok; sub-second polling é limitado. Em produção, webhooks são fortemente recomendados.

Finish

Confirma a ativação e dispara a cobrança. Idempotente — chamar duas vezes é 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 qualquer SMS. Retorna 409 se já chegou um SMS (então chame finish).

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

← AnteriorInício rápido Seguinte →Authentication