Takvim
Programınız, randevu sayfaları ve hizmetler.
Calendar'ın bir rezervasyonun iki tarafı için herkese açık yöntemleri vardır. Bazıları sizin, sahibin adına hareket eder ve API anahtarınızı alır: kurulumunuzu ve rezervasyonlarınızı okur, kaynakları, hizmetleri ve sayfaları kurar, bir zamanı bekletir ve onaylar, iptal eder ve planı değiştirir. Diğerleri, bir rezervasyon sayfasının bir ziyaretçi için yaptıklarıdır. Anahtar gerektirmezler, yalnızca sayfanın anahtarını isterler.
Takvimleri başkalarıyla paylaşmak, görünümler, görevler, gün etkinlikleri ve Takvim ayarları kontrol panelinde yapılır. Bugün için herkese açık yöntemleri yoktur.
Anahtarınızla bir yönteme istek gönderin:
İyi bir yanıtın code değeri 1'dir. Planınızın içermediği bir değişiklik, code -62 ve data içinde bir cümleyle reddedilir; örneğin grup oturumları için Growth gerektiği ya da planınızın belirli sayıda rezervasyon sayfası barındırdığı. Size düzenleme düzeyinde paylaşılan bir hesabın takvimi üzerinde işlem yapmak için, birini alan yöntemlere onun share_id değerini verin.
Kurulumunuzu ve rezervasyonlarınızı okuyun
get_calendar_setup, Calendar ekranlarının çizdiği her şeyi tek çağrıda yanıtlar: saatleriyle rezerve edilebilir kişiler ve odalar, hizmetler ve herkese açık adresleriyle yayımlanmış rezervasyon sayfaları.get_calendar_bookingsrezervasyonları listeler; varsayılan olarak yaklaşanları. Zaten gerçekleşmiş olanlar için, en yeniden başlayarak,pastdeğerinitrueverin ve kaç tane istediğiniz içinlimitverin. Her satır, kaynağın diliminde zamanı, konuğun bilgilerini ve rezervasyon sırasında söylediği her şeyi taşır.get_calendar_slots, bir kaynak üzerindeki bir hizmetinfrom_tsileto_ts(epoch milisaniye) arasındaki rezerve edilebilir zamanlarını listeler; zaten alınmış olanlar dışarıda bırakılır.
Nelerin rezerve edilebileceğini kurun
save_calendar_resource, rezerve edilebilen bir şeyi oluşturur veya günceller: bir kişi, bir oda, bir koltuk ya da bir cihaz. Birtimezonegerektirir,Asia/Jerusalemgibi bir IANA dilimi; saatleri o dilimde okunur. Yenisini oluşturmak içinresource_idvermeyin.save_calendar_service, insanların rezerve edebildiği şeyi oluşturur veya günceller: süresi, tamponları, önceden bildirimi, ne kadar önceden rezerve edilebileceği, koltukları, nerede buluştuğu (meeting_kind) veprice_cents,currencyilecheckoutile ne kadara mal olduğu ve rezervasyonda ödenip ödenmediği. Birden fazla koltuk, grup oturumlarını içeren bir plan gerektirir ve ödeme almak, ödemeleri içeren bir plan gerektirir.save_calendar_pagebir rezervasyon sayfasını oluşturur veya günceller:title,intro, sunduğuservice_ids,enabledolup olmadığı,accentrengi,bg_colorvetext_color(her biri#rrggbbya da sayfanın onu vurgudan türetmesi için boş),show_host, ziyaretçilerin rezervasyonlarını değiştirip değiştiremeyeceği (visitor_changes,change_hours,refund_percent) ve ödemenin yattığı finans hesabı (finance_account_id). Planınızın sayfa sınırının ötesinde bir sayfa oluşturmak reddedilir.delete_calendar_item,item_idile bir kaynağı, bir hizmeti veya bir sayfayı kaldırır. Rezervasyonlar bu şekilde asla silinmez: iptal edilirler.
Kendiniz bir zaman rezerve edin
Kendi kodunuzdan rezervasyon iki adımdır; böylece bir zaman asla iki kez satılmaz.
Zamanı bekletin
hold_calendar_slot bir zamanı birkaç dakikalığına ayırır. resource_id, service_id ve start_utc (epoch milisaniye) verin. İyi bir yanıtın data alanında occ_id, hold_token ve expires_at bulunur. Çağrının tekrarının ikinci bir koltuk almak yerine aynı beklemeyi döndürmesi için bir idem_key gönderin.
Onaylayın
confirm_calendar_booking beklemeyi bir rezervasyona çevirir. Bekletmeden gelen occ_id ve hold_token ile konuğun name, email, phone ve note değerlerini verin. Artık var olmayan bir bekletme zamanı kaybetmiştir ve reddedilir.
Bir rezervasyonu değiştirin
cancel_calendar_booking,booking_idile iptal eder ve zamanı herkese açık ızgaraya geri koyar. İki kez çağırmak güvenlidir. Yalnızca zamanı serbest bırakır: konuğa e-posta göndermez ve ödemeyi iade etmez; bunu kontrol panelindeki Randevuyu iptal et, sayfanız üzerinden rezerve eden bir konuk için yapar.notify_calendar_guests, bir rezervasyona davet edilen herkese, her birine ayrı bir ileti olarak, takvim daveti ekli ve en çok 2000 karakterlik isteğe bağlı birmessageile e-posta gönderir.kind, yeni bir randevu içininvite, bir değişiklik içinupdatedeğerini alır; varsayılan budur. E-posta, bunu içeren bir planda kendi posta kutunuzdan, aksi halde yanıt adresi sizin adresiniz olacak şekilde Xuda'nın rezervasyon adresinden gelir.create_booking_room, odası olmayan onaylanmış bir görüntülü rezervasyonun Xuda Meet odasını oluşturur ve her konuğa bağlantıyı gönderir.
Bir rezervasyon sayfasının çağırdıkları
Bir rezervasyon sayfası, sayfa anahtarıyla, <uid>.<page_id>, ve hesapsız çalışır.
get_booking_bootstrap, bir sayfanın kendini çizmek için ihtiyaç duyduğunu yanıtlar: başlığı, hizmetleri ve taze bir bot karşıtı belirteç.get_public_booking_slots, bir ziyaretçinin seçebileceği zamanları listeler; her birinin bir başlangıcı, bir bitişi ve bir koltuk sayısı vardır. Diğer koltukları kimin tuttuğunu asla söylemez.public_book_slot, bir ziyaretçiden bir rezervasyon alır.page_key,service_id,start_utc,tokenile ziyaretçininnameveemaildeğerlerini verin. Çift basışın iki kez rezerve etmemesi için biridem_keyekleyin.company_websitebotlar için bir tuzaktır: boş bırakın.- Rezervasyonda ödenen bir hizmet için
public_start_paid_bookingzamanı bekletir ve ödemeyi başlatır,start_booking_paymentbekletilen bir zamanı Stripe'a gönderir vepublic_confirm_paid_bookingileconfirm_paid_booking, ödeme tamamlandığında onu rezerve eder. Hiçbir şey rezerve edilmeden önce ödeme Stripe'tan geri okunur. - Bir ziyaretçi, e-postasındaki özel bağlantıdan bir rezervasyonu yönetir.
get_public_booking,public_cancel_bookingvepublic_reschedule_booking, sayfa anahtarını ve o bağlantınınmanagedeğerini alır. Sayfanın kurallarını izlerler: ziyaretçilerin bir rezervasyonu değiştirip değiştiremeyeceği ve başlamasından en çok kaç saat öncesine kadar. Ücretli bir rezervasyon, önce sayfanın iade yüzdesiyle iade edilir.
Plan
get_calendar_plans, dört kademeyi fiyatları ve her birinin neyi taşıdığıyla, hangi planda olduğunuzu ve Calendar'ın açık olup olmadığını yanıtlar. calendar_set_plan onu açar, kademeyi değiştirir ya da kapatır: plan_id değerini calendar_free, calendar_starter, calendar_growth veya calendar_business olarak verin ya da deactivate değerini true yapın. Bkz. Planlar ve faturalandırma.