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

# Uwierzytelnianie

> Uwierzytelniaj każde żądanie do Aniva Partner API swoim partnerskim kluczem API w nagłówku x-api-key i nie umieszczaj klucza w kodzie przeglądarki.

Wszystkie żądania do Aniva Partner API muszą zawierać twój partnerski klucz API w nagłówku żądania `x-api-key`.

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

> [!NOTE]
>
> Skontaktuj się z Aniva, aby uzyskać swój klucz API. Klucze są wydawane na konto partnerskie.

## Wysyłanie uwierzytelnionych żądań

Dołączaj nagłówek `x-api-key` do każdego żądania wysyłanego do 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();
```

## Odpowiedzi z błędami

Jeśli twoje żądanie nie ma nagłówka `x-api-key`, API odpowiada `401 Unauthorized`.

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

Jeśli klucz API jest nieprawidłowy, API odpowiada `401 Unauthorized`.

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

Jeśli klucz jest prawidłowy, ale nie ma zakresu uprawnień dla tego endpointu, API odpowiada `403 Forbidden`.

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

Jeśli otrzymasz jeden z tych błędów, sprawdź, czy:

1. Twoje żądanie zawiera nagłówek `x-api-key`.
2. Wartość klucza API jest poprawna i klucz nie został zrotowany.
3. Twój klucz ma zakres uprawnień wymagany przez endpoint. Każdy endpoint w dokumentacji API podaje swój zakres uprawnień.

> [!WARNING]
>
> Nigdy nie ujawniaj swojego klucza API w kodzie po stronie klienta ani w publicznych repozytoriach. Traktuj go jak hasło.

Skontaktuj się z Aniva, aby zrotować ujawniony klucz lub poprosić o zmianę uprawnień swojego klucza API.


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