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

# Автентифікація

> Автентифікуй кожен запит до Aniva Partner API за допомогою свого партнерського ключа API в заголовку x-api-key і не розміщуй ключ у коді браузера.

Усі запити до Aniva Partner API мають містити твій партнерський API-ключ у заголовку запиту `x-api-key`.

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

> [!NOTE]
>
> Звернися до Aniva, щоб отримати свій API-ключ. Ключі видаються для кожного партнерського акаунта.

## Надсилання автентифікованих запитів

Додавай заголовок `x-api-key` до кожного запиту до 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();
```

## Відповіді з помилками

Якщо у твоєму запиті немає заголовка `x-api-key`, API відповідає `401 Unauthorized`.

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

Якщо API-ключ недійсний, API відповідає `401 Unauthorized`.

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

Якщо ключ дійсний, але не має області доступу для ендпоінта, API відповідає `403 Forbidden`.

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

Якщо ти отримуєш одну з цих помилок, перевір, що:

1. У твоєму запиті є заголовок `x-api-key`.
2. Значення API-ключа правильне, і його не перевипускали.
3. Твій ключ має область доступу, якої вимагає ендпоінт. Для кожного ендпоінта в довіднику API вказано його область доступу.

> [!WARNING]
>
> Ніколи не розкривай свій API-ключ у клієнтському коді чи публічних репозиторіях. Стався до нього як до пароля.

Звернися до Aniva, щоб перевипустити скомпрометований ключ або попросити змінити дозволи свого API-ключа.


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