📘 Docs para desenvolvedor

Receba seu primeiro SMS em 90 segundos

API REST, 4 SDKs tipados, webhooks assinados, chaves de idempotência, pools single-tenant no Enterprise. Referência completa + código funcional na sua linguagem.

Quickstart

Três chamadas e está pronto

  1. 1
    Compre um número

    Escolha país + serviço. Atribuímos um número de telefone real do pool upstream saudável mais barato.

    curl -X POST https://api.eveses.com/api/v1/numbers/orders \
      -H "Authorization: Bearer $KEY" \
      -d '{"country":"ua","mode":"activation","service":"telegram"}'
    
    # → 201 Created · 142ms
    # { "order_id":"ord_91f3a2b8", "phone":"+380635551822", "status":"waiting", "price_cents":7 }
  2. 2
    Aguarde o SMS · polling ou webhook

    Assine o webhook activation.sms_received ou faça polling. A chegada de SMS no p95 é de 2,1 segundos.

    curl https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/sms \
      -H "Authorization: Bearer $KEY"
    
    # → 200 OK · 87ms
    # { "status":"sms_received", "sms":[{ "otp":"123456", "received_at":"..." }] }
  3. 3
    Finalize — fundos são debitados

    Até você chamar finish, os fundos ficam retidos, não gastos. Cancele a qualquer momento dentro da janela para reembolso total.

    curl -X POST https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/finish \
      -H "Authorization: Bearer $KEY"
    
    # → 200 OK · 61ms
    # { "status":"finished", "charged_cents":7 }

Navegue pelas docs

Pesquisáveis, com exemplos em 4 linguagens, e sandbox Try-it ao vivo em cada endpoint.

📦 SDKs tipados

4 linguagens · todos gerados a partir do mesmo spec OpenAPI · com retry automático · erros tipados.

JS@eveses/sdkPYEvesesGOevesescom/go-sdkPHPeveses/sdk
RBeveses-rb (soon)
RSeveses-rs (soon)
JVeveses-java (soon)

Pronto para lançar?

Primeira ativação por nossa conta · sem cartão · reembolso se não houver SMS.

⚡ Cadastre-se — comece a construir
FIQUE POR DENTRO

Novas geos, novos pools, novos endpoints.

Quase toda semana adicionamos países, rotacionamos pools e publicamos mudanças na API. Deixe seu e-mail e enviamos o que importa: nova cobertura geográfica, mudanças na escala de preços e tudo que quebra uma integração.

✓ Novas geos e produtos⚡ Mudanças que quebram a API🫥 Nunca spam

Cancele a inscrição com um clique. Nunca compartilhamos seu e-mail.