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

# Autentizace

> Ověřuj každý požadavek na Aniva Partner API svým partnerským API klíčem v hlavičce x-api-key a nevkládej klíč do kódu v prohlížeči.

Všechny požadavky na Aniva Partner API musí obsahovat tvůj partnerský API klíč v hlavičce požadavku `x-api-key`.

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

> [!NOTE]
>
> Pro získání svého API klíče kontaktuj Aniva. Klíče se vydávají pro každý partnerský účet.

## Odesílání ověřených požadavků

Do každého požadavku na API přidej hlavičku `x-api-key`.

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

## Chybové odpovědi

Pokud tvůj požadavek nemá hlavičku `x-api-key`, API odpoví `401 Unauthorized`.

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

Pokud API klíč není platný, API odpoví `401 Unauthorized`.

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

Pokud je klíč platný, ale nemá scope pro daný endpoint, API odpoví `403 Forbidden`.

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

Pokud některou z těchto chyb dostaneš, ověř, že:

1. Tvůj požadavek obsahuje hlavičku `x-api-key`.
2. Hodnota API klíče je správná a klíč nebyl obměněn.
3. Tvůj klíč má scope, který endpoint vyžaduje. Každý endpoint v referenci API uvádí svůj scope.

> [!WARNING]
>
> Nikdy nezveřejňuj svůj API klíč v klientském kódu ani ve veřejných repozitářích. Zacházej s ním jako s heslem.

Kontaktuj Anivu, pokud potřebuješ obměnit kompromitovaný klíč nebo požádat o změnu oprávnění svého API klíče.


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