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

# Autenticación

> Configura tus credenciales y accede a la API de Tupana

# Autenticación

Para comenzar a utilizar la API de Tupana, necesitarás configurar la autenticación correctamente. Utilizamos un sistema de API Keys para garantizar la seguridad de tus transacciones.

## Obtener tu API Key

1. Ingresa a tu panel de control
2. Ve a "Configuración > API"
3. Haz clic en "Generar Nueva API Key"
4. Guarda tu API Key en un lugar seguro - no podrás verla nuevamente

## Usar tu API Key

### Headers de Autenticación

Para autenticarte con la API, incluye tu API Key en el header de tus peticiones usando el prefijo `Api-Key`:

```bash theme={null}
curl -X POST https://api.tupana.ai/v1/documents \
  -H "Authorization: Api-Key TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "33", ...}'
```

### Ejemplo en Python

```python theme={null}
import requests

api_key = "tu_api_key"
headers = {
    "Authorization": f"Api-Key {api_key}",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.tupana.ai/v1/documents",
    headers=headers,
    json={"type": "33", ...}
)
```

## Seguridad

### Mejores Prácticas

1. **Nunca compartas tu API Key**
2. Rota tus API Keys regularmente
3. Utiliza diferentes API Keys para producción y desarrollo
4. Monitorea el uso de tus API Keys

### Manejo de Errores

Si recibes un error de autenticación (401), verifica:

1. Que estás usando la API Key correcta
2. Que la API Key no ha expirado
3. Que el formato del header es correcto (debe ser `Authorization: Api-Key TU_API_KEY`)
4. Que la API Key está activa en tu panel de control

## Siguientes Pasos

Una vez configurada la autenticación, puedes:

1. Emitir tu primer documento
2. Explorar los endpoints disponibles
3. Configurar webhooks para notificaciones