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

# Authentifizierung

> Authentifiziere jede Anfrage an die Aniva Partner API mit deinem Partner-API-Schlüssel im x-api-key-Header und halte den Schlüssel aus dem Browser-Code fern.

Alle Anfragen an die Aniva Partner-API müssen deinen Partner-API-Schlüssel im Request-Header `x-api-key` enthalten.

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

> [!NOTE]
>
> Kontaktiere Aniva, um deinen API-Schlüssel zu erhalten. Schlüssel werden pro Partnerkonto ausgestellt.

## Authentifizierte Anfragen senden

Sende den `x-api-key`-Header bei jeder Anfrage an die API mit.

```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();
```

## Fehlerantworten

Wenn deine Anfrage keinen `x-api-key`-Header enthält, antwortet die API mit `401 Unauthorized`.

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

Wenn der API-Schlüssel ungültig ist, antwortet die API mit `401 Unauthorized`.

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

Wenn der Schlüssel gültig ist, aber nicht den Scope für den Endpunkt hat, antwortet die API mit `403 Forbidden`.

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

Wenn du einen dieser Fehler erhältst, prüfe Folgendes:

1. Deine Anfrage enthält den `x-api-key`-Header.
2. Der Wert des API-Schlüssels ist korrekt und wurde nicht rotiert.
3. Dein Schlüssel hat den Scope, den der Endpunkt benötigt. Jeder Endpunkt in der API-Referenz nennt seinen Scope.

> [!WARNING]
>
> Gib deinen API-Schlüssel niemals in clientseitigem Code oder öffentlichen Repositories preis. Behandle ihn wie ein Passwort.

Kontaktiere Aniva, um einen kompromittierten Schlüssel zu rotieren oder Änderungen an den Berechtigungen deines API-Schlüssels anzufordern.


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