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

# Konumlar

> Aniva API'sinde test noktaları nasıl çalışır: kan alma hizmeti veren eczaneler ve muayenehaneler, çalışma saatleri, müsaitlik ve perakende fiyatlar.

Konum, sağlık profesyonelleri tarafından kan alma işleminin yapıldığı fiziksel bir test merkezidir. `practitioner` randevuları planlamak için bir konumun `id` değerini kullanırsın.

> [!NOTE]
>
> API anahtarın yalnızca iş ortağı erişim bağlamındaki konumları döndürür. Kullanabileceğin tüm
> konumları listelemek için `GET
>     /api/v1/locations` kullan.

Bir `location.*` [webhook](https://docs.anivahealth.com/tr/concepts/webhooks.md) bildirimi, bir konum eklendiğinde, değiştiğinde veya kaldırıldığında sana haber verir.

## Alanlar

**id** `string` *required*

Konumun UUID değeri. Randevu oluştururken bunu `location_id` olarak ilet.

**name** `string` *required*

Konumun görünen adı.

**company\_name** `string`

Konumu işleten klinik veya şirket. Null olabilir.

**street** `string`

Bina numarası hariç sokak adı. Null olabilir.

**house\_number** `string`

Bina numarası. Null olabilir.

**address\_line\_2** `string`

Ek adres satırı — c/o, bina veya kat. Null olabilir.

**city** `string`

Şehir. Null olabilir.

**state** `string`

Eyalet veya il (şehrin bağlı olduğu eyalet üzerinden çözümlenir). Şehrin bağlı bir eyaleti yoksa
null olabilir.

**state\_code** `string`

Eyaletin ülke ön eki olmadan [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) kodu
(ör. Baden-Württemberg için `BW`). Null olabilir.

**postal\_code** `string`

Posta veya ZIP kodu. Null olabilir.

**country\_name** `string`

Tam ülke adı (ör. `Germany`). Null olabilir.

**country\_code** `string`

[ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) standardına göre iki harfli
ülke kodu (ör. `DE`, `US`). Null olabilir.

**timezone** `string`

Konum için IANA saat dilimi tanımlayıcısı (ör. `Europe/Berlin`, `America/New_York`). Planlanan
saatleri doğru yerel saatte göstermek için bunu kullan. Null olabilir.

**latitude** `number`

Adresin ondalık derece cinsinden enlemi (WGS 84). Null olabilir.

**longitude** `number`

Adresin ondalık derece cinsinden boylamı (WGS 84). Null olabilir.

**contact\_phone** `string`

Konumun telefon numarası. Null olabilir.

**email** `string`

Konumun e-posta adresi. Null olabilir.

**website** `string`

Konumun web sitesi URL'si. Null olabilir.

**google\_maps\_url** `string`

Konumun Google Maps'teki doğrudan bağlantısı. Null olabilir.

**image\_url** `string`

Konumun bir fotoğrafının URL'si. Null olabilir.

**open\_hours** `object`

Konumun haftalık çalışma saatleri. Her gün anahtarı (`monday`–`sunday`), `HH:MM` (24 saat)
biçimindeki `{ open, close }` saat aralıklarından oluşan bir diziye karşılık gelir. Boş bir dizi,
konumun o gün kapalı olduğu anlamına gelir. Konum için çalışma saatleri mevcut değilse null olabilir.

**default\_draw\_method** `string` *required*

Randevu kendi `draw_method` değerini belirlemediği sürece buradaki bir randevuda kanın nasıl
alındığı: `capillary` (parmak ucundan veya üst koldan, mikrotüplere) veya `venous` (damardan,
tüplere).

**draw\_methods** `string[]` *required*

Konumun numune kabı bulundurduğu kan alma yöntemleri, sıralı olarak. Buradaki bir randevu,
`draw_method` olarak bunlardan yalnızca birini belirleyebilir.

> [!TIP]
>
> `scheduled_at` tarih ve saatlerini hastalara veya personele göstermeden önce yerel saate
> dönüştürmek için her zaman `timezone` alanını kullan.

## Müsaitlik

Yukarıdaki `open_hours` alanı, sabit haftalık çalışma programını tanımlar. Gerçekten rezerve edilebilir zaman aralıklarını göstermek ve mevcut Aniva randevularıyla çifte rezervasyonu önlemek için konumun [Müsaitliği al](https://docs.anivahealth.com/tr/api/locations/get-availability.md) uç noktasını çağır ve göstermek istediğin tarih aralığını ilet. Bu uç nokta, her türlü rezervasyon arayüzü için doğru bilgi kaynağıdır: `open_hours` alanını konumun zaman aralığı ızgarasına yayar, tarihe özel istisnaları uygular, önceden alınmış randevuları çıkarır ve [minimum bildirim süresini](https://docs.anivahealth.com/tr/api/appointments/create-appointment.md#minimum-bildirim-sueresi) uygular.

## Perakende fiyatları

Bir eczane, doğrudan gelen müşterilere sattığı her panel ve her tekil biyobelirteç için kendi
fiyatını belirler. Bir fiyatı ancak eczane yayımladıktan sonra görürsün.
[Perakende fiyatlarını listele](https://docs.anivahealth.com/tr/api/locations/list-retail-prices.md), okuyabildiğin her konum için bu
fiyatları döndürür; [Perakende fiyatlarını al](https://docs.anivahealth.com/tr/api/locations/get-retail-prices.md) ise tek bir konum
için döndürür. Her ikisi de `retail_prices_view` kapsamını gerektirir; `locations_view` bunları
içermez. Aynı konumlar için her iki kapsamı da iste.

`location.retail_prices.updated` [webhook'u](https://docs.anivahealth.com/tr/concepts/webhooks.md), bir fiyat değiştiğinde sana bildirir.
`location.created` ve `location.deactivated`, bir konum eklendiğinde veya kaldırıldığında sana bildirir.
Bir konumun sunduğu panellerdeki bir değişiklik sana fiyat değişikliğinden daha geç ulaşabilir; bu yüzden
günde bir kez Perakende fiyatlarını listele uç noktasını tekrar oku.

## Örnek konum

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "name": "Mitte Health Center",
  "company_name": "Aniva Berlin GmbH",
  "street": "Friedrichstraße",
  "house_number": "100",
  "address_line_2": null,
  "city": "Berlin",
  "state": "Berlin",
  "state_code": "BE",
  "postal_code": "10117",
  "country_name": "Germany",
  "country_code": "DE",
  "timezone": "Europe/Berlin",
  "latitude": 52.531677,
  "longitude": 13.388042,
  "contact_phone": "+493012345678",
  "email": "berlin@anivahealth.com",
  "website": "https://anivahealth.com",
  "google_maps_url": "https://maps.google.com/?q=Friedrichstra%C3%9Fe+100+Berlin",
  "image_url": "https://anivahealth.com/images/locations/berlin-mitte.jpg",
  "open_hours": {
    "monday": [{ "open": "08:00", "close": "18:00" }],
    "tuesday": [{ "open": "08:00", "close": "18:00" }],
    "wednesday": [{ "open": "08:00", "close": "18:00" }],
    "thursday": [{ "open": "08:00", "close": "18:00" }],
    "friday": [{ "open": "08:00", "close": "16:00" }],
    "saturday": [],
    "sunday": []
  },
  "default_draw_method": "venous",
  "draw_methods": ["venous"]
}
```


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