OTP por e-mail · API simples

Verificação por código, sem dor de cabeça.

pygmy envia e valida códigos OTP por e-mail para todos os seus projetos. Uma API enxuta, segura e pronta para usar em minutos.

Experimentar Ver a API

6 dígitosgerados com fonte criptográfica
5 minde validade e uso único
5 tentativasantes de invalidar o código
60 sde intervalo entre reenvios

Teste ao vivo

Recursos

Tudo que um OTP precisa, nada além.

Feito para ser plugado em qualquer projeto pessoal ou profissional.

E-mail bonito, pronto

Template HTML moderno com modo escuro e fallback em texto. Você só informa o nome do seu app.

Seguro por padrão

Código guardado apenas como hash, uso único, expira em minutos e bloqueia após tentativas erradas.

Um serviço, vários projetos

Uma credencial por projeto, com espaço isolado: o mesmo e-mail em dois apps nunca se mistura.

Duas chamadas e pronto

POST para pedir, POST para validar. Sem SDK, sem dependências: funciona com qualquer linguagem.

Anti-abuso embutido

Intervalo entre reenvios e limite de pedidos por hora, por e-mail e por IP do usuário final.

Painel de credenciais

Crie, desative, gire e revogue chaves em segundos, com métricas de uso dos últimos 14 dias.

Como funciona

Três passos, um fluxo.

Peça o código

Seu backend chama POST /v1/otp/request com o e-mail do usuário.

Usuário recebe

Um e-mail elegante chega com o código de 6 dígitos, válido por 5 minutos.

Valide

Seu backend chama POST /v1/otp/verify e recebe {"verified": true}.

API

Integre em minutos.

Autentique com Authorization: Bearer <chave>. Chame sempre do seu backend — nunca exponha a chave no navegador.

# 1) pedir o código
curl -X POST https://pygmy.gabrielbarbosadev.com.br/v1/otp/request \
  -H "Authorization: Bearer $PYGMY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@exemplo.com","app_name":"Minha Loja"}'

# 2) validar o código digitado
curl -X POST https://pygmy.gabrielbarbosadev.com.br/v1/otp/verify \
  -H "Authorization: Bearer $PYGMY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@exemplo.com","code":"482916"}'

POST/v1/otp/request

Envia o código. Body: email, opcional app_name.

202 enviado · 429 aguarde/limite · 503 falha no e-mail

POST/v1/otp/verify

Valida o código. Body: email, code.

200 verificado · 400 inválido/expirado · 429 tentativas excedidas

HEADERX-End-User-IP

Opcional. IP do seu usuário final, para ativar o limite por IP.

Documentação interativa em /docs

Pronto para verificar?

Teste o fluxo completo agora mesmo, com o seu e-mail.

Fazer o teste