Rezervasyonlar
Müsait saatleri listele
Mekanın rezervasyon takvimi: istenen günler ve her birinde hala alınabilen saatler.
/public/v1/venues/{venueId}/reservation-availabilityMekanın rezervasyon takvimini gün gün döndürür. Bu, mekanın cibusy.com'daki kendi rezervasyon sayfasının gösterdiği takvimin aynısıdır ve bir rezervasyonun uyması gereken kurallarla hesaplanır; yani burada listelenen bir saat, rezervasyon alma çağrısının kabul ettiği bir saattir. Misafire saatin time değerini gösterin (mekanın kendi saatiyle yazılıdır), isteğe ise startsAt değerini koyun.
Saatler yarım saat arayla ve mekanın rezervasyon aldığı saatler içinde listelenir: çalışma saatleri ya da mekanın bunları daralttığı rezervasyon saatleri. Hiçbiri minNoticeMinutes dakikadan yakın ya da lastBookableDate tarihinden sonra değildir. Gece yarısından sonra da misafir alan bir mekanda o geç saatler, ait oldukları akşamın günü altında yer alır. Mekanın kapalı olduğu gün Closed, o hafta günü için çalışma saati girilmemiş gün HoursUnknown okunur; ikisinde de saat yoktur.
reservationsEnabled, rezervasyon almayı kapatmış bir mekanda false olur: days o zaman boştur ve gönderilen rezervasyon reddedilir. confirmsAutomatically yeni bir rezervasyonun ne olacağını söyler: hemen Confirmed ya da mekan yanıtlayana kadar Pending.
Takvim mekanın ne zaman misafir aldığını söyler, ne kadar dolu olduğunu değil: Cibusy masa saymaz ve yer olmayan bir isteği mekan reddeder.
Parametreler
venueIdstring · uuidYol parametresizorunluMekan; GET /venues listesindeki kimliklerden biri.
fromstringSorgu parametresiİstenen ilk gün, mekanın takvimine göre, yyyy-MM-dd biçiminde. Verilmezse ya da bugünden önceyse mekanın bugünü.
daysintegerSorgu parametresiKaç gün: verilmezse 7. Kaç gün istenirse istensin en fazla 14 gün döner.
Accept-LanguagestringBaşlıkHata yanıtlarındaki userMessage metninin dili: tr (varsayılan), en, de, fr, it, es, ar ya da ru. Başlıktaki ilk dil belirler, bölgesi olmadan (en-US, en okunur) ve q ağırlıklarına bakılmadan; Cibusy'nin sunmadığı bir dil Türkçe yanıtlanır. Menünün dilini seçmez; o, menü çağrısındaki lang parametresidir.
Yanıtlar
Mekanın rezervasyon takvimi.
X-Api-Key başlığı yok (PUBLIC_API_KEY_MISSING) ya da anahtar geçersiz veya iptal edilmiş (PUBLIC_API_KEY_INVALID).
PUBLIC_API_SCOPE_MISSING: anahtar "Rezervasyon alabilir" izniyle oluşturulmamış.
Mekan yok ya da bu anahtar ona ulaşamıyor (PUBLIC_API_VENUE_NOT_FOUND).
Anahtarın dakikada yaklaşık 120 isteklik bütçesi doldu; Retry-After kadar saniye bekleyin.
Retry-AfterBeklenecek saniye. Bir sonraki dakikalık pencere bu süre içinde açılır.
Başarılı yanıtın data alanı
Bir mekanda rezervasyon alınabilen saatler, gün gün, ve bir rezervasyonun uyması gereken kurallar. Mekanın cibusy.com'daki kendi rezervasyon sayfasının gösterdiği takvimin aynısıdır; burada listelenen bir saati rezervasyon alma çağrısı kabul eder.
venueIdstring · uuidMekan.
reservationsEnabledbooleanMekanın rezervasyon alıp almadığı. false olduğunda days boştur ve gönderilen rezervasyon RESERVATIONS_DISABLED ile reddedilir.
confirmsAutomaticallybooleanMekanın rezervasyonu alındığı anda onaylayıp onaylamadığı. false olduğunda yeni rezervasyon, mekan yanıtlayana kadar Pending kalır.
timeZonestringMekanın saat diliminin IANA adı: her saatin time değeri bu saat dilimine göredir.
maxGuestsintegerAPI üzerinden rezervasyon yapılabilecek en kalabalık grup. Daha kalabalık bir grup mekanı arar.
minNoticeMinutesintegerBir rezervasyonun en az kaç dakika önceden yapılması gerektiği.
lastBookableDatestringMekanın takvimine göre, masa ayırtılabilecek son tarih.
daysobject[]İstenen günler, sırasıyla. Mekan rezervasyon almıyorsa boş.
Takvim günü alanları
datestringTarih, mekanın takvimine göre. Gece yarısından sonra da misafir alan bir mekanda o geç saatler, ait oldukları akşamın günü altında listelenir.
statestringBu gün masa ayırtılıp ayırtılamadığı.
Open- Mekan bu gün rezervasyon alıyor. `slots`, hala alınabilen saatlerdir.
Closed- Mekan kapalı: tatil günü ya da kapalı olarak işaretlediği bir tarih.
HoursUnknown- Mekan bu hafta günü için çalışma saati girmemiş; bu gün için saat sunulamaz.
slotsobject[]Hala alınabilen saatler, en erken önce. Gün Open değilse boş.
Müsait saat alanları
startsAtstring · date-timeSaat, UTC bir an olarak: rezervasyonu alırken startsAt olarak gönderilecek değer.
timestringAynı saat, mekanın kendi saatiyle, HH:mm biçiminde: misafire gösterilecek değer.