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

# Authenticatie

> Authenticeer elk verzoek aan de Aniva Partner API met je partner-API-sleutel in de header x-api-key en houd de sleutel buiten browsercode.

Alle verzoeken aan de Aniva Partner API moeten je partner-API-sleutel bevatten in de requestheader `x-api-key`.

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

> [!NOTE]
>
> Neem contact op met Aniva om je API-sleutel op te vragen. Sleutels worden per partneraccount uitgegeven.

## Geauthenticeerde verzoeken versturen

Neem de `x-api-key`-header op in elk verzoek aan de 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();
```

## Foutresponsen

Als je verzoek geen `x-api-key`-header bevat, antwoordt de API met `401 Unauthorized`.

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

Als de API-sleutel niet geldig is, antwoordt de API met `401 Unauthorized`.

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

Als de sleutel geldig is, maar niet de scope voor het endpoint heeft, antwoordt de API met `403 Forbidden`.

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

Als je een van deze fouten krijgt, controleer dan of:

1. Je verzoek de `x-api-key`-header bevat.
2. De waarde van de API-sleutel klopt en niet is geroteerd.
3. Je sleutel de scope heeft die het endpoint vereist. Elk endpoint in de API-referentie vermeldt zijn scope.

> [!WARNING]
>
> Zet je API-sleutel nooit in client-side code of openbare repositories. Behandel hem als een wachtwoord.

Neem contact op met Aniva om een gecompromitteerde sleutel te roteren of om wijzigingen in de rechten van je API-sleutel aan te vragen.


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