Autenticação

Todas as requisições à API exigem uma chave de API válida enviada como Bearer token.

Bearer Token

Autentique-se incluindo sua chave de API no Authorization cabeçalho de toda requisição:

http

Authorization: Bearer YOUR_API_KEY

Sua chave de API é uma string longa que começa com ev_. Por exemplo:

http

Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Onde encontrar sua chave de API

Entre na sua conta em verimails.com/dashboard
Vá até Configurações → Chaves de API
Copie sua chave

⚠️

Mantenha sua chave de API em segredo. Nunca a inclua em JavaScript do lado do cliente nem em repositórios públicos, e não a compartilhe com terceiros não confiáveis. Se ela for comprometida, gere uma nova imediatamente pelo painel.

Exemplo de requisição autenticada

bash

curl -X POST https://verimails.com/api/verify/single \
  -H "Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

Erros de autenticação

Se sua chave estiver ausente ou for inválida, você receberá uma resposta 401 Unauthorized :

json

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "status_code": 401
}

ℹ️

Precisa de várias chaves de API para ambientes ou aplicações diferentes? Você pode gerar chaves adicionais pelo painel.