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

# Autenticación

> Autentica cada petición a la API de partners de Aniva con tu clave API de partner en la cabecera x-api-key y mantén la clave fuera del código del navegador.

Todas las peticiones a la API de partners de Aniva deben incluir tu clave de API de partner en la cabecera `x-api-key` de la petición.

```http theme={null}
x-api-key: your-api-key-here
```

> [!NOTE]
>
> Contacta con Aniva para obtener tu clave de API. Las claves se emiten por cuenta de partner.

## Enviar peticiones autenticadas

Incluye la cabecera `x-api-key` en cada petición que hagas a la API.

```bash cURL theme={null}
curl https://anivahealth.com/api/v1/locations \
  -H "x-api-key: YOUR_API_KEY"
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/locations', {
  headers: {
    'x-api-key': 'YOUR_API_KEY',
  },
});

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

## Respuestas de error

Si tu petición no tiene la cabecera `x-api-key`, la API responde con `401 Unauthorized`.

```json theme={null}
{
  "error": "This endpoint requires API key authentication"
}
```

Si la clave de API no es válida, la API responde con `401 Unauthorized`.

```json theme={null}
{
  "error": "Invalid API key"
}
```

Si la clave es válida pero no tiene el scope del endpoint, la API responde con `403 Forbidden`.

```json theme={null}
{
  "error": "Insufficient permissions: requires appointments_schedule scope"
}
```

Si recibes uno de estos errores, comprueba que:

1. Tu petición incluya la cabecera `x-api-key`.
2. El valor de la clave de API sea correcto y no se haya rotado.
3. Tu clave tenga el scope que requiere el endpoint. Cada endpoint de la referencia de la API indica su scope.

> [!WARNING]
>
> Nunca expongas tu clave de API en código del lado del cliente ni en repositorios públicos. Trátala como una contraseña.

Contacta con Aniva para rotar una clave comprometida o solicitar cambios en los permisos de tu clave de API.


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