İçeriğe geç

Takvim

Programınız, randevu sayfaları ve hizmetler.

Takvim aç
19 Kasım 2026 tarihinde kontrol paneliyle karşılaştırıldı

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:

curl -s https://xuda.ai/cpi/get_calendar_setup \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","uid":"YOUR_ACCOUNT_UID"}'
const res = await fetch('https://xuda.ai/cpi/get_calendar_setup', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    uid: 'YOUR_ACCOUNT_UID',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_calendar_setup',
    json={
        'api_key': 'YOUR_API_KEY',
        'uid': 'YOUR_ACCOUNT_UID',
    },
)

İ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_bookings rezervasyonları listeler; varsayılan olarak yaklaşanları. Zaten gerçekleşmiş olanlar için, en yeniden başlayarak, past değerini true verin ve kaç tane istediğiniz için limit verin. 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 hizmetin from_ts ile to_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. Bir timezone gerektirir, Asia/Jerusalem gibi bir IANA dilimi; saatleri o dilimde okunur. Yenisini oluşturmak için resource_id vermeyin.
  • 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) ve price_cents, currency ile checkout ile 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_page bir rezervasyon sayfasını oluşturur veya günceller: title, intro, sunduğu service_ids, enabled olup olmadığı, accent rengi, bg_color ve text_color (her biri #rrggbb ya 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_id ile 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.

curl -s https://xuda.ai/cpi/hold_calendar_slot \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","uid":"YOUR_ACCOUNT_UID","resource_id":"RESOURCE_ID","service_id":"SERVICE_ID","start_utc":1793000000000}'
const res = await fetch('https://xuda.ai/cpi/hold_calendar_slot', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    uid: 'YOUR_ACCOUNT_UID',
    resource_id: 'RESOURCE_ID',
    service_id: 'SERVICE_ID',
    start_utc: 1793000000000,
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/hold_calendar_slot',
    json={
        'api_key': 'YOUR_API_KEY',
        'uid': 'YOUR_ACCOUNT_UID',
        'resource_id': 'RESOURCE_ID',
        'service_id': 'SERVICE_ID',
        'start_utc': 1793000000000,
    },
)

Bir rezervasyonu değiştirin

  • cancel_calendar_booking, booking_id ile 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ı bir message ile e-posta gönderir. kind, yeni bir randevu için invite, bir değişiklik için update değ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, token ile ziyaretçinin name ve email değerlerini verin. Çift basışın iki kez rezerve etmemesi için bir idem_key ekleyin. company_website botlar için bir tuzaktır: boş bırakın.
  • Rezervasyonda ödenen bir hizmet için public_start_paid_booking zamanı bekletir ve ödemeyi başlatır, start_booking_payment bekletilen bir zamanı Stripe'a gönderir ve public_confirm_paid_booking ile confirm_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_booking ve public_reschedule_booking, sayfa anahtarını ve o bağlantının manage değ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.

Tüm yöntemler

Bu kılavuz nasıl?

Son güncelleme: 19 Kasım 2026