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

# Autenticación

> Usa una API Key desde el servidor, gestiona su rotación y resuelve errores de acceso.

<span id="keys" />

## API Keys

Crea las claves en [API Keys del dashboard](https://app.cotizave.com). Empiezan por `ctz_live_` y tienen 47 caracteres. Se muestran completas una sola vez. `ctz_live_...` en esta documentación es un placeholder, no una clave utilizable.

<span id="como" />

## Enviar la credencial

```http theme={null}
GET /v1/fx/rates HTTP/1.1
Host: api.cotizave.com
X-API-Key: ctz_live_...
Accept: application/json
```

Lee `COTIZAVE_API_KEY` desde la configuración privada del servidor y elimina espacios al principio y al final. Usa los [clientes del inicio rápido](/api/quickstart#paso-2), que rechazan redirecciones y comprueban las respuestas. La clave se envía en la cabecera, nunca en la URL.

<span id="gestion" />

## Crear, rotar y revocar

Para sustituir una clave, usa la rotación del dashboard. Puedes invalidar la anterior al rotar; los planes de pago también permiten mantenerla durante 60 minutos para desplegar la nueva. Si hay una filtración, elige revocación sin convivencia. La clave nueva se muestra una vez: actualiza tus servicios antes de que termine la ventana elegida.

La revocación no permite recuperar ni reactivar la clave. Crear varias claves no multiplica la cuota mensual de la cuenta.

<span id="seguridad" />

## Mantener la clave en el servidor

El navegador o una app distribuida a usuarios debe consultar tu backend. No incluyas la clave en bundles, repositorios, mensajes de error, logs ni capturas. Mantén la verificación TLS activada. Una API Key y un secreto de firma de webhooks son credenciales distintas.

<span id="respuestas" />

## Errores de acceso

| Estado / código | Acción |
| - | - |
| `401 invalid_api_key` | Revisa presencia, formato y copia de la clave. |
| `401 key_revoked` | Usa una clave vigente. |
| `403 email_not_verified` | Verifica el correo en el dashboard. |
| `403 account_inactive` | Revisa el estado de la cuenta. |
| `402 feature_not_in_plan` | Comprueba el acceso a la función o mercado. |
| `429 rate_limit_exceeded` | Comprueba alcance y espera en las cabeceras. |

<span id="proximos" />

## Continuar

Consulta [cuotas](/api/rate-limits) y [errores](/api/errors). No reintentes una clave inválida repetidamente: también puede activarse una protección por IP.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.