Ana içeriğe atla
GET
İ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ı.
Konumları listele 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 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

string
gerekli
Konum kimliği (UUID). Konumları listele yanıtındaki id değerini kullan.

Sorgu parametreleri

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.
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ı.
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.
string
gerekli
Yansıtılan konum kimliği.
string
gerekli
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.
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.
array
gerekli
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:

Hata yanıtları