Saltar al contenido principal
La API de Enrow utiliza autenticación mediante clave de API. Cada solicitud debe incluir tu clave de API en el encabezado x-api-key. No hay flujos de OAuth ni tokens de portador que gestionar: una sola clave de API autentica todos los endpoints.

¿Cómo obtengo mi clave de API?

  1. Regístrate en app.enrow.io
  2. Haz clic en API en el menú de la izquierda
  3. Copia tu clave de API
Mantén tu clave de API segura y nunca la incluyas en el control de versiones. Trátala como una contraseña. Si una clave queda expuesta alguna vez, rótala: consulta Buenas prácticas.

¿Cómo autentico una solicitud?

Incluye tu clave de API en el encabezado x-api-key en cada solicitud:
curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "John Doe",
    "company_domain": "example.com"
  }'
El mismo encabezado x-api-key funciona para todos los endpoints: Email Finder, Email Verifier, Phone Finder e Información de la cuenta.

¿Por qué recibo un error 401?

Una respuesta 401 Unauthorized significa que tu clave de API falta o no es válida. Si la clave de API no es válida, recibirás:
{
  "message": "This apikey is not valid"
}
Si no se proporciona ninguna clave de API, el message será "No apikey found in the x-api-key headers". Para ver la lista completa de códigos de estado y formatos de error, consulta Códigos de estado y Gestión de errores.

¿Cómo consulto mi cuenta y mis créditos?

Puedes recuperar la información de tu cuenta (saldo de créditos y webhooks registrados) usando el mismo encabezado x-api-key: no se necesita ningún cuerpo en la solicitud:
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
Para entender cómo se consumen los créditos en cada endpoint, consulta Créditos y facturación.

Buenas prácticas

Almacena tu clave de API en variables de entorno en lugar de codificarla directamente:
export ENROW_API_KEY="your_api_key_here"
Para mayor seguridad, rota tus claves de API periódicamente y revoca las claves que no uses.
Crea claves de API independientes para los entornos de desarrollo, staging y producción.

Próximos pasos

Encontrar un email

Busca una dirección de email profesional a partir de un nombre y una empresa.

Verificar un email

Comprueba si una dirección de email es válida y entregable.

Créditos y facturación

Consulta cómo se consumen los créditos en cada endpoint.

Límites de tasa

Entiende los límites de solicitudes de la API antes de escalar.