Autenticación

Todas las peticiones a la API requieren una clave de API válida enviada como token Bearer.

Token Bearer

Autentícate incluyendo tu clave de API en la cabecera Authorization de cada petición:

http

Authorization: Bearer YOUR_API_KEY

Tu clave de API es una cadena larga que empieza por ev_. Por ejemplo:

http

Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Dónde encontrar tu clave de API

Inicia sesión en tu cuenta en verimails.com/dashboard
Ve a Ajustes → Claves de API
Copia tu clave

⚠️

Mantén tu clave de API en secreto. Nunca la incluyas en JavaScript del lado del cliente ni en repositorios públicos, ni la compartas con terceros que no sean de confianza. Si se ve comprometida, regénerala de inmediato desde el panel.

Ejemplo de petición 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"}'

Errores de autenticación

Si tu clave falta o no es válida, recibirás una respuesta 401 Unauthorized :

json

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

ℹ️

¿Necesitas varias claves de API para distintos entornos o aplicaciones? Puedes generar claves adicionales desde el panel.