# Autenticación

> URL: https://foura.ai/es/docs/getting-started/authentication
> Updated: 2026-10-29
> Index: https://foura.ai/llms.txt

Cada request a la API de FourA requiere autenticación. Esta página explica cómo obtener, usar y gestionar tu API key.

## Cómo obtener tu API key

1. Inicia sesión en el [FourA Dashboard](https://foura.ai/dashboard)
2. Ve a la página **API Keys**
3. Haz clic en **Create Key**
4. Copia la key del diálogo de confirmación

Tu API key se ve así: `pk_live_a1b2c3d4e5f6...`

Las keys creadas hoy son revelables: haz clic en el icono del ojo en la fila de la key más tarde para ver el secret completo bajo demanda (consulta [Managing API Keys](https://foura.ai/docs/dashboard/api-keys) para el flujo de revelado y permisos). Las keys heredadas creadas antes del lanzamiento de esta función no se pueden volver a mostrar y tienen un icono de candado; regeneralas una vez para cambiarlas.

## Cómo usar tu API key

Incluye tu API key en el header `X-API-Key` de cada request:

```bash
curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'
```

En Python:

```python
import requests

response = requests.post(
    "https://eu.api.foura.ai/api/single/",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"method": "GET", "url": "https://example.com"}
)
```

En Node.js:

```javascript
const response = await fetch('https://eu.api.foura.ai/api/single/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ method: 'GET', url: 'https://example.com' })
});
```

## Seguridad de la API key

Trata tu API key como una contraseña:

- **No la confirmes en el control de versiones.** Usa variables de entorno en su lugar.
- **No la expongas en código del lado del cliente.** Úsala únicamente en aplicaciones del lado del servidor.
- **Rótala si se ve comprometida.** Regenera la key desde el Dashboard. El secreto anterior dejará de funcionar en un minuto, y cada visualización queda registrada en el log de auditoría para que sea fácil detectar una credencial robada a posteriori.

### Uso de variables de entorno

Guarda tu key en una variable de entorno:

```bash
export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."
```

Luego haz referencia a él en tu código:

```python
import os
api_key = os.environ["FOURA_API_KEY"]
```

```javascript
const apiKey = process.env.FOURA_API_KEY;
```

## Errores comunes de autenticación

Todos los fallos de autenticación devuelven un estado `401 Unauthorized`.

| Error | Mensaje | Causa | Solución |
|-------|---------|-------|-----|
| 401 | Missing API key. Include X-API-Key header. | Falta el header `X-API-Key` en la request | Añade el header `X-API-Key` |
| 401 | Invalid API key | Key incorrecta, espacios en blanco adicionales o key desactivada | Verifica la key, elimina los espacios en blanco o genera una nueva key desde el Dashboard |

Si FourA no puede verificar una key temporalmente, por ejemplo durante una conmutación por error en su base de datos, responde `503` con `API key check temporarily unavailable` y `Retry-After: 5`, nunca `401`. Reintenta la solicitud tras esa espera: tu key no tiene problemas.

Cada response, sea un éxito o un fallo, incluye un header `X-Foura-Request-Id`, salvo en el caso de un body que FourA no pueda leer en absoluto (JSON mal formado o un body que supere los 100 KB), el cual se rechaza antes de asignar un ID. Regístralo en tus logs para que el equipo de soporte pueda consultar una llamada específica más adelante.

## Siguientes pasos

- [Inicio rápido](https://foura.ai/docs/getting-started/quick-start): Haz tu primera request
- [Gestión de API keys](https://foura.ai/docs/dashboard/api-keys): Revela, edita, regenera y elimina keys
- [Endpoints de la API](https://foura.ai/docs/api/endpoints): Referencia completa de endpoints
- [Manejo de errores](https://foura.ai/docs/api/errors): Gestiona los errores de autenticación de forma adecuada
