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

# Kimlik doğrulama

> Her Aniva Partner API isteğini x-api-key başlığındaki partner API anahtarınla doğrula ve anahtarı tarayıcı kodunun dışında tut.

Aniva Partner API'ye yapılan tüm isteklerde iş ortağı API anahtarın `x-api-key` istek başlığında yer almalıdır.

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

> [!NOTE]
>
> API anahtarını almak için Aniva ile iletişime geç. Anahtarlar iş ortağı hesabı başına verilir.

## Kimliği doğrulanmış istekler gönderme

API'ye yaptığın her isteğe `x-api-key` başlığını ekle.

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

## Hata yanıtları

İsteğinde `x-api-key` başlığı yoksa API `401 Unauthorized` yanıtı verir.

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

API anahtarı geçerli değilse API `401 Unauthorized` yanıtı verir.

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

Anahtar geçerli ancak uç nokta için gerekli kapsama sahip değilse API `403 Forbidden` yanıtı verir.

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

Bu hatalardan birini alırsan şunları doğrula:

1. İsteğinin `x-api-key` başlığını içerdiğini.
2. API anahtarı değerinin doğru olduğunu ve yenilenmediğini.
3. Anahtarının, uç noktanın gerektirdiği kapsama sahip olduğunu. API referansındaki her uç nokta kendi kapsamını belirtir.

> [!WARNING]
>
> API anahtarını asla istemci tarafı kodda veya herkese açık depolarda açığa çıkarma. Onu bir parola gibi koru.

Ele geçirilmiş bir anahtarı yenilemek veya API anahtarı izinlerinde değişiklik istemek için Aniva ile iletişime geç.


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