> ## 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"
}
```

Если ключ действителен, но у него нет нужного scope для эндпоинта, API отвечает `403 Forbidden`.

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

Если ты получаешь одну из этих ошибок, проверь, что:

1. В твоём запросе есть заголовок `x-api-key`.
2. Значение API-ключа верное, и он не был перевыпущен.
3. У твоего ключа есть scope, который требуется для эндпоинта. В справочнике API у каждого эндпоинта указан его scope.

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

Свяжись с Aniva, чтобы перевыпустить скомпрометированный ключ или запросить изменение прав доступа своего API-ключа.


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