İçeriğe geç

Rezervasyonlar

Müsait saatleri listele

Mekanın rezervasyon takvimi: istenen günler ve her birinde hala alınabilen saatler.

GET/public/v1/venues/{venueId}/reservation-availability
Kimlik doğrulama

X-Api-Key başlığında API anahtarı

Gereken izin
Rezervasyon alabilir
Hız sınırı
Anahtar başına dakikada yaklaşık 120 istek

Mekanı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 parametresizorunlu

Mekan; 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 parametresi

Kaç gün: verilmezse 7. Kaç gün istenirse istensin en fazla 14 gün döner.

Accept-LanguagestringBaşlık

Hata 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

200

Mekanın rezervasyon takvimi.

401

X-Api-Key başlığı yok (PUBLIC_API_KEY_MISSING) ya da anahtar geçersiz veya iptal edilmiş (PUBLIC_API_KEY_INVALID).

403

PUBLIC_API_SCOPE_MISSING: anahtar "Rezervasyon alabilir" izniyle oluşturulmamış.

404

Mekan yok ya da bu anahtar ona ulaşamıyor (PUBLIC_API_VENUE_NOT_FOUND).

429

Anahtarın dakikada yaklaşık 120 isteklik bütçesi doldu; Retry-After kadar saniye bekleyin.

Retry-After

Beklenecek 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 · uuid

Mekan.

reservationsEnabledboolean

Mekanın rezervasyon alıp almadığı. false olduğunda days boştur ve gönderilen rezervasyon RESERVATIONS_DISABLED ile reddedilir.

confirmsAutomaticallyboolean

Mekanın rezervasyonu alındığı anda onaylayıp onaylamadığı. false olduğunda yeni rezervasyon, mekan yanıtlayana kadar Pending kalır.

timeZonestring

Mekanın saat diliminin IANA adı: her saatin time değeri bu saat dilimine göredir.

maxGuestsinteger

API üzerinden rezervasyon yapılabilecek en kalabalık grup. Daha kalabalık bir grup mekanı arar.

minNoticeMinutesinteger

Bir rezervasyonun en az kaç dakika önceden yapılması gerektiği.

lastBookableDatestring

Mekanı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ı
datestring

Tarih, 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.

statestring

Bu 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-time

Saat, UTC bir an olarak: rezervasyonu alırken startsAt olarak gönderilecek değer.

timestring

Aynı saat, mekanın kendi saatiyle, HH:mm biçiminde: misafire gösterilecek değer.