> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticación

> Cómo autenticar las solicitudes de la API de Enrow con tu clave de API en el encabezado x-api-key

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](https://app.enrow.io)
2. Haz clic en **API** en el menú de la izquierda
3. Copia tu clave de API

<Warning>
  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](#best-practices).
</Warning>

## ¿Cómo autentico una solicitud?

Incluye tu clave de API en el encabezado `x-api-key` en cada solicitud:

<CodeGroup>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.enrow.io/email/find/single', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      fullname: 'John Doe',
      company_domain: 'example.com'
    })
  });

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.enrow.io/email/find/single"
  headers = {
      "Content-Type": "application/json",
      "x-api-key": "YOUR_API_KEY"
  }
  payload = {
      "fullname": "John Doe",
      "company_domain": "example.com"
  }

  response = requests.post(url, json=payload, headers=headers)
  data = response.json()
  ```
</CodeGroup>

El mismo encabezado `x-api-key` funciona para todos los endpoints: [Email Finder](/es/api-reference/email-finder/find-single), [Email Verifier](/es/api-reference/email-verifier/verify-single), [Phone Finder](/es/api-reference/phone/find-single) e [Información de la cuenta](/es/api-reference/account/info).

## ¿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:

```json theme={null}
{
  "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](/es/status-codes) y [Gestión de errores](/es/error-handling).

## ¿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:

```bash theme={null}
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
```

```json Response theme={null}
{
  "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](/es/credits-billing).

## Buenas prácticas

<AccordionGroup>
  <Accordion title="Usa variables de entorno">
    Almacena tu clave de API en variables de entorno en lugar de codificarla directamente:

    ```bash theme={null}
    export ENROW_API_KEY="your_api_key_here"
    ```
  </Accordion>

  <Accordion title="Rota las claves periódicamente">
    Para mayor seguridad, rota tus claves de API periódicamente y revoca las claves que no uses.
  </Accordion>

  <Accordion title="Usa claves distintas para entornos distintos">
    Crea claves de API independientes para los entornos de desarrollo, staging y producción.
  </Accordion>
</AccordionGroup>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Encontrar un email" icon="envelope" href="/es/api-reference/email-finder/find-single">
    Busca una dirección de email profesional a partir de un nombre y una empresa.
  </Card>

  <Card title="Verificar un email" icon="circle-check" href="/es/api-reference/email-verifier/verify-single">
    Comprueba si una dirección de email es válida y entregable.
  </Card>

  <Card title="Créditos y facturación" icon="coins" href="/es/credits-billing">
    Consulta cómo se consumen los créditos en cada endpoint.
  </Card>

  <Card title="Límites de tasa" icon="gauge-high" href="/es/rate-limits">
    Entiende los límites de solicitudes de la API antes de escalar.
  </Card>
</CardGroup>