Ana içeriğe atla
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.
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 bildirimi, bir konum eklendiğinde, değiştiğinde veya kaldırıldığında sana haber verir.

Alanlar

string
gerekli
Konumun UUID değeri. Randevu oluştururken bunu location_id olarak ilet.
string
gerekli
Konumun görünen adı.
string
Konumu işleten klinik veya şirket. Null olabilir.
string
Bina numarası hariç sokak adı. Null olabilir.
string
Bina numarası. Null olabilir.
string
Ek adres satırı — c/o, bina veya kat. Null olabilir.
string
Şehir. Null olabilir.
string
Eyalet veya il (şehrin bağlı olduğu eyalet üzerinden çözümlenir). Şehrin bağlı bir eyaleti yoksa null olabilir.
string
Eyaletin ülke ön eki olmadan ISO 3166-2 kodu (ör. Baden-Württemberg için BW). Null olabilir.
string
Posta veya ZIP kodu. Null olabilir.
string
Tam ülke adı (ör. Germany). Null olabilir.
string
ISO 3166-1 alpha-2 standardına göre iki harfli ülke kodu (ör. DE, US). Null olabilir.
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.
number
Adresin ondalık derece cinsinden enlemi (WGS 84). Null olabilir.
number
Adresin ondalık derece cinsinden boylamı (WGS 84). Null olabilir.
string
Konumun telefon numarası. Null olabilir.
string
Konumun e-posta adresi. Null olabilir.
string
Konumun web sitesi URL’si. Null olabilir.
string
Konumun Google Maps’teki doğrudan bağlantısı. Null olabilir.
string
Konumun bir fotoğrafının URL’si. Null olabilir.
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.
string
gerekli
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).
string[]
gerekli
Konumun numune kabı bulundurduğu kan alma yöntemleri, sıralı olarak. Buradaki bir randevu, draw_method olarak bunlardan yalnızca birini belirleyebilir.
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 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 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, okuyabildiğin her konum için bu fiyatları döndürür; Perakende fiyatlarını al 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, 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