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

# Autentificare

> Autentifică fiecare cerere către Aniva Partner API cu cheia ta API de partener în antetul x-api-key și nu include cheia în codul din browser.

Toate cererile către Aniva Partner API trebuie să includă cheia ta API de partener în antetul cererii `x-api-key`.

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

> [!NOTE]
>
> Contactează Aniva pentru a obține cheia ta API. Cheile sunt emise pentru fiecare cont de partener.

## Trimiterea cererilor autentificate

Include antetul `x-api-key` în fiecare cerere pe care o trimiți către 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ăspunsuri de eroare

Dacă cererea ta nu are antetul `x-api-key`, API-ul răspunde cu `401 Unauthorized`.

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

Dacă cheia API nu este validă, API-ul răspunde cu `401 Unauthorized`.

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

Dacă cheia este validă, dar nu are scope-ul pentru endpoint, API-ul răspunde cu `403 Forbidden`.

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

Dacă primești una dintre aceste erori, verifică dacă:

1. Cererea ta include antetul `x-api-key`.
2. Valoarea cheii API este corectă și nu a fost rotită.
3. Cheia ta are scope-ul cerut de endpoint. Fiecare endpoint din referința API își menționează scope-ul.

> [!WARNING]
>
> Nu expune niciodată cheia ta API în codul client-side sau în repository-uri publice. Trateaz-o ca pe o parolă.

Contactează Aniva pentru a roti o cheie compromisă sau pentru a solicita modificări ale permisiunilor cheii tale API.


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