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

# Müsaitliği getir

> Tek bir konum için rezerve edilebilir zaman dilimi başlangıçlarını getir

İstenen aralıkta tek bir konum için rezerve edilebilir zaman dilimi başlangıçlarını döndürür.
Zaman dilimleri konumun `open_hours` bilgisinden oluşturulur, genel / konuma özel kapalı tarihler
atlanır ve önceden alınmış Aniva randevuları çıkarılır; böylece sonuç, hastalarının istemci
tarafında gerçekten ayırtabileceği saatleri yansıtır.

`appointments_schedule` kapsamını gerektirir. Konum ayrıca API anahtarının konum grubu erişim bağlamı içinde yer almalı.

> [!NOTE]
>
> [Konumları listele](https://docs.anivahealth.com/tr/api/locations/list-locations.md) tarafından döndürülen statik `open_hours`
> bilgisinden müsaitlik çıkarmak yerine bu uç noktayı kullan — yalnızca bu uç nokta anlık
> rezervasyonları, tarihe özel program istisnalarını ve Aniva'nın işlettiği konumlardaki 12 saatlik
> [minimum bildirim süresini](https://docs.anivahealth.com/tr/api/appointments/create-appointment.md#minimum-bildirim-sueresi) hesaba katar.
> Burada döndürülen her zaman dilimi olduğu gibi rezerve edilebilir.

Yanıtlar `Cache-Control: private, max-age=30, stale-while-revalidate=60` başlığını taşır, bu
yüzden bir tarayıcı \~30 saniyeye kadar önbelleğe alınmış bir yük sunabilir — bu süre içinde alınan
bir zaman dilimi bir sonraki yenilemeye kadar hâlâ rezerve edilebilir görünebilir. Rezervasyon
anında da çakışmaları göster.

## Yol parametreleri

**id** `string` *required*

Konum kimliği (UUID). [Konumları listele](https://docs.anivahealth.com/tr/api/locations/list-locations.md) yanıtındaki `id` değerini kullan.

## Sorgu parametreleri

**start\_date** `string`

Aralığın `YYYY-MM-DD` biçimindeki kapsayıcı başlangıcı (`timezone` içinde yorumlanır). İsteğe
bağlı. İki tarih de verilmediğinde varsayılan olarak **bugün**, yalnızca `end_date` verildiğinde
ise **`end_date − 30 days`** olur. Geçmiş tarihler sessizce bugüne çekilir.

**end\_date** `string`

Aralığın `YYYY-MM-DD` biçimindeki kapsayıcı bitişi (`timezone` içinde yorumlanır). İsteğe bağlı.
İki tarih de verilmediğinde varsayılan olarak **bugün + 30 gün**, yalnızca `start_date`
verildiğinde ise **`start_date + 30 days`** olur. `start_date` tarihinde veya sonrasında ve
bugünden itibaren 90 gün içinde olmalı.

**timezone** `string`

`start_date` / `end_date` değerlerini yorumlamak ve zaman dilimlerini takvim tarihine göre
gruplamak için kullanılan IANA saat dilimi (örn. `Europe/Berlin`). İsteğe bağlı — varsayılan
olarak konumun kendi saat dilimi kullanılır. Zaman dilimi başlangıç saatleri her zaman UTC anları
(`Z`) olarak sunulur ve bu parametreyle asla kaymaz — zaman dilimi ızgarası her zaman konumun
kendi saat diliminden yansıtılır; parametre yalnızca bir zaman diliminin hangi takvim günü
altında gruplanacağını etkiler. Yanıttaki gün girdileri bu saat diliminde tam olarak
`start_date`..`end_date` takvim günlerini kapsar. Seçiciyi başka bir saat diliminde
göstermiyorsan bunu ekleme.

## Yanıt

İşlem başarılı olduğunda API, tek bir müsaitlik nesnesiyle `200 OK` döndürür.

**location\_id** `string` *required*

Yansıtılan konum kimliği.

**timezone** `string` *required*

Yanıtın sunulduğu IANA saat dilimi (örn. `Europe/Berlin`) — verildiğinde `timezone` sorgu
parametresini, aksi halde konumun kendi saat dilimini yansıtır.

**slot\_interval\_minutes** `integer`

Ardışık rezerve edilebilir zaman dilimi başlangıçları arasındaki dakika cinsinden aralık.
Konumda yapılandırılmış ızgara adımı — `availability` içindeki her zaman dilimi bu ızgaraya
oturur. Yalnızca konumun planlama yapılandırması yoksa `null` olur. **Bir randevu süresi aralığı
değildir:** farklı başlangıç saatlerindeki çakışan rezervasyonlar birbiriyle çelişmez; eş
zamanlılık için yalnızca tam başlangıç çakışmaları sayılır.

**availability** `array` *required*

Gün bazında rezerve edilebilir zaman dilimleri. Yükü küçük tutmak için rezerve edilebilir zaman
dilimi olmayan günler dahil edilmez. Her girdide şunlar bulunur:

**günlük girdi**

**date** `string` *required*

Yanıtın `timezone` saat dilimindeki takvim tarihi (`YYYY-MM-DD`).

**slots** `array` *required*

Artan sırayla UTC anları olarak zaman dilimi başlangıçları (`Z` sonekli ISO 8601).

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Geçersiz konum kimliği, geçersiz tarih veya saat dilimi biçimi, `end_date` değerinin `start_date` öncesinde olması veya `end_date` değerinin 90 günden daha ileride olması. |
| `403` | Yasak — `appointments_schedule` kapsamı eksik veya konum erişim bağlamının dışında. |
| `404` | Konum bulunamadı veya etkin değil. |
| `500` | İç sunucu hatası. |

```bash cURL theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/locations/b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b/availability?start_date=2026-05-01&end_date=2026-05-07' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "timezone": "Europe/Berlin",
  "slot_interval_minutes": 15,
  "availability": [
    {
      "date": "2026-05-04",
      "slots": ["2026-05-04T07:00:00Z", "2026-05-04T07:15:00Z", "2026-05-04T07:30:00Z"]
    },
    {
      "date": "2026-05-05",
      "slots": ["2026-05-05T06:00:00Z", "2026-05-05T06:15:00Z"]
    }
  ]
}
```


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