> ## 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ó

> Autentica cada sol·licitud a l'Aniva Partner API amb la teva clau d'API de col·laborador a la capçalera x-api-key i mantén la clau fora del codi del navegador.

Totes les sol·licituds a l'API de col·laboradors d'Aniva han d'incloure la teva clau d'API de col·laborador a la capçalera de sol·licitud `x-api-key`.

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

> [!NOTE]
>
> Contacta amb Aniva per obtenir la teva clau d'API. Les claus s'emeten per compte de col·laborador.

## Enviament de sol·licituds autenticades

Inclou la capçalera `x-api-key` a cada petició que facis a l'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();
```

## Respostes d'error

Si la teva petició no té la capçalera `x-api-key`, l'API respon amb `401 Unauthorized`.

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

Si la clau d'API no és vàlida, l'API respon amb `401 Unauthorized`.

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

Si la clau és vàlida però no té el scope per a l'endpoint, l'API respon amb `403 Forbidden`.

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

Si reps un d'aquests errors, comprova que:

1. La teva petició inclogui la capçalera `x-api-key`.
2. El valor de la clau d'API sigui correcte i no s'hagi rotat.
3. La teva clau tingui el scope que requereix l'endpoint. Cada endpoint de la referència de l'API indica el seu scope.

> [!WARNING]
>
> No exposis mai la teva clau d'API en codi de client ni en repositoris públics. Tracta-la com una contrasenya.

Contacta amb Aniva per rotar una clau compromesa o per sol·licitar canvis en els permisos de la teva clau d'API.


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