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

# Authentification

> Authentifie chaque requête vers l'API partenaire Aniva avec ta clé API partenaire dans l'en-tête x-api-key, et garde la clé hors du code du navigateur.

Toutes les requêtes vers l'API partenaire Aniva doivent inclure ta clé API partenaire dans l'en-tête de requête `x-api-key`.

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

> [!NOTE]
>
> Contacte Aniva pour obtenir ta clé API. Les clés sont délivrées par compte partenaire.

## Envoyer des requêtes authentifiées

Inclus l'en-tête `x-api-key` dans chaque requête que tu envoies à 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();
```

## Réponses d'erreur

Si ta requête n'a pas d'en-tête `x-api-key`, l'API répond `401 Unauthorized`.

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

Si la clé API n'est pas valide, l'API répond `401 Unauthorized`.

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

Si la clé est valide mais n'a pas le scope pour l'endpoint, l'API répond `403 Forbidden`.

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

Si tu reçois l'une de ces erreurs, vérifie que :

1. Ta requête inclut l'en-tête `x-api-key`.
2. La valeur de la clé API est correcte et n'a pas été renouvelée.
3. Ta clé a le scope requis par l'endpoint. Chaque endpoint dans la référence API indique son scope.

> [!WARNING]
>
> N'expose jamais ta clé API dans du code côté client ou des dépôts publics. Traite-la comme un mot de passe.

Contacte Aniva pour renouveler une clé compromise ou demander des modifications aux permissions de ta clé API.


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