Início rápido

Introdução

A Eveses fornece números de telefone sob demanda para verificações por SMS. Você pede um número, recebe o código de uso único e só paga se o SMS realmente chegar.

Esta página guia você pela sua primeira requisição end-to-end em três passos.

1. Crie uma chave de API

Faça login e abra Account → API Keys. Clique em New key, dê um nome (por exemplo, local-dev) e copie o valor exibido no diálogo. O token é mostrado apenas uma vez — guarde-o imediatamente no seu gerenciador de senhas ou em um arquivo .env.

export EVESES_API_KEY="17|aBcDeFgHiJ…"

2. Solicite um número

Escolha um país (ISO-2) e um slug de serviço (telegram, whatsapp, discord, any, …) e faça POST em /v1/activations:

curl -X POST https://api.eveses.com/v1/activations \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "ua", "service": "telegram", "duration_minutes": 5}'

A resposta traz o número e um id de ativação pelo qual você pegará o código:

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"waiting","price_cents":50,"expires_at":"2026-05-26T14:35:00Z"}

3. Leia o código do SMS

Insira o número no formulário de verificação do serviço terceiro e consulte a ativação até o SMS chegar:

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

Quando o SMS chegar, a resposta contém um array sms com o OTP. A maioria dos provedores entrega em 30 segundos. Se nada chegar até o prazo, não há cobrança.

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"sms_received","price_cents":50,"expires_at":"2026-05-26T14:35:00Z","sms":[{"code":"123456","text":"Your code: 123456","received_at":"2026-05-26T14:30:14Z"}]}

Próximos passos

• Pare o polling, use webhooks — assine activation.sms_received e enviaremos o OTP. Veja a seção Webhooks.
• Use um SDK — bibliotecas oficiais para PHP, JavaScript, Python e Go estão em SDKs.
• Leia sobre idempotência — envolva a criação em um Idempotency-Key para que retries não dobrem a cobrança.