Přeskočit na obsah

Kalendář

Váš rozvrh, rezervační stránky a služby.

Otevřít Kalendář
Ověřeno podle nástěnky dne 19. listopadu 2026

Calendar má veřejné metody pro obě strany rezervace. Některé jednají za vás, vlastníka, a berou váš klíč API: čtou vaše nastavení a rezervace, nastavují zdroje, služby a stránky, drží a potvrzují čas, ruší a mění tarif. Jiné jsou ty, které rezervační stránka volá pro návštěvníka. Nepotřebují klíč, jen klíč stránky.

Sdílení kalendářů s jinými lidmi, zobrazení, úkoly, celodenní události a Nastavení kalendáře se dělají v dashboardu. Dnes pro ně neexistuje veřejná metoda.

Pošlete požadavek metodě se svým klíčem:

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',
    },
)

Dobrá odpověď má code 1. Změna, kterou váš tarif nezahrnuje, je odmítnuta s code -62 a větou v data, například že skupinové schůzky potřebují Growth nebo že váš tarif pojme určitý počet rezervačních stránek. Chcete-li jednat s kalendářem účtu, který vám ho sdílel na úrovni úprav, předejte jeho share_id metodám, které ho berou.

Čtení nastavení a rezervací

  • get_calendar_setup odpoví jedním voláním na vše, co obrazovky Calendar kreslí: rezervovatelné osoby a místnosti s jejich hodinami, služby a zveřejněné rezervační stránky s jejich veřejnými adresami.
  • get_calendar_bookings vypisuje rezervace, ve výchozím stavu nadcházející. Předejte past nastavené na true pro ty, které už proběhly, od nejnovější, a limit pro jejich počet. Každý řádek nese čas v pásmu zdroje, údaje hosta a vše, co řekl při rezervaci.
  • get_calendar_slots vypisuje rezervovatelné časy jedné služby u jednoho zdroje mezi from_ts a to_ts (epoch milisekundy), bez všeho, co je již obsazeno.

Nastavení toho, co lze rezervovat

  • save_calendar_resource vytvoří nebo aktualizuje něco, co lze rezervovat: osobu, místnost, křeslo nebo zařízení. Potřebuje timezone, pásmo IANA jako Asia/Jerusalem, a jeho hodiny se čtou v tomto pásmu. Vynechejte resource_id, chcete-li vytvořit nový.
  • save_calendar_service vytvoří nebo aktualizuje to, co si lidé mohou rezervovat: délku, rezervy, předstih, jak daleko dopředu lze rezervovat, místa, kde se schází (meeting_kind) a, pomocí price_cents, currency a checkout, kolik stojí a zda se platí při rezervaci. Více než jedno místo potřebuje tarif, který zahrnuje skupinové schůzky, a přijímání plateb potřebuje tarif, který zahrnuje platby.
  • save_calendar_page vytvoří nebo aktualizuje rezervační stránku: její title, intro, service_ids, které nabízí, zda je enabled, její barvu accent, její bg_color a text_color (každé #rrggbb, nebo prázdné, aby ji stránka odvodila ze zvýraznění), show_host, zda návštěvníci mohou měnit svou rezervaci (visitor_changes, change_hours, refund_percent) a finanční účet, na který se platí (finance_account_id). Vytvoření stránky nad limit stránek vašeho tarifu je odmítnuto.
  • delete_calendar_item odebere zdroj, službu nebo stránku podle item_id. Rezervace se takto nikdy nemažou: ruší se.

Rezervace času sami

Rezervace z vlastního kódu má dva kroky, takže se jeden čas nikdy neprodá dvakrát.

Podržte čas

hold_calendar_slot rezervuje čas na několik minut. Předejte resource_id, service_id a start_utc (epoch milisekundy). Dobrá odpověď má data s occ_id, hold_token a expires_at. Pošlete idem_key, aby opakování volání vrátilo stejné podržení místo druhého místa.

Potvrďte ho

confirm_calendar_booking změní podržení na rezervaci. Předejte occ_id a hold_token z podržení a name, email, phone a note hosta. Podržení, které už neexistuje, o čas přišlo a je odmítnuto.

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,
    },
)

Změna rezervace

  • cancel_calendar_booking ruší podle booking_id a vrací čas na veřejnou mřížku. Je bezpečné ji zavolat dvakrát. Jen uvolní čas: nepošle hostovi e-mail ani nevrátí platbu, což dělá Zrušit schůzku v dashboardu pro hosta, který rezervoval přes vaši stránku.
  • notify_calendar_guests pošle e-mail všem pozvaným na jednu rezervaci, každému jednu zprávu, s přiloženým pozváním do kalendáře a volitelnou message do 2000 znaků. kind je invite pro novou schůzku a update pro změnu, což je výchozí. E-mail přichází z vaší vlastní poštovní schránky v tarifu, který ji zahrnuje, a jinak z rezervační adresy Xuda, s vaší adresou jako adresou pro odpověď.
  • create_booking_room vytvoří místnost Xuda Meet pro potvrzenou video rezervaci, která žádnou nemá, a pošle každému hostovi odkaz.

Co volá rezervační stránka

Rezervační stránka pracuje se svým klíčem stránky, <uid>.<page_id>, a bez účtu.

  • get_booking_bootstrap odpoví na to, co stránka potřebuje k vykreslení: její název, služby a čerstvý protibotový token.
  • get_public_booking_slots vypisuje časy, které může návštěvník zvolit, každý se začátkem, koncem a počtem míst. Nikdy neříká, kdo drží ostatní místa.
  • public_book_slot přijme rezervaci od návštěvníka. Předejte page_key, service_id, start_utc, token a name a email návštěvníka. Přidejte idem_key, aby dvojí stisknutí nerezervovalo dvakrát. company_website je past na boty: nechte ho prázdné.
  • U služby, která se platí při rezervaci, public_start_paid_booking podrží čas a zahájí platbu, start_booking_payment pošle podržený čas do Stripe a public_confirm_paid_booking a confirm_paid_booking ji zarezervují, jakmile platba projde. Platba se před jakoukoli rezervací načte zpět ze Stripe.
  • Návštěvník spravuje rezervaci ze soukromého odkazu ve svém e-mailu. get_public_booking, public_cancel_booking and public_reschedule_booking berou klíč stránky a hodnotu manage toho odkazu. Řídí se pravidly stránky: zda smějí návštěvníci rezervaci měnit a do kolika hodin před začátkem. Zaplacená rezervace se nejdřív vrací podle procenta vrácení stránky.

Tarif

get_calendar_plans odpoví čtyřmi stupni s jejich cenami a tím, co každý nese, na kterém tarifu jste a zda je Calendar zapnutý. calendar_set_plan ho zapne, změní stupeň nebo ho vypne: předejte plan_id jako calendar_free, calendar_starter, calendar_growth nebo calendar_business, nebo nastavte deactivate na true. Viz Tarify a fakturace.

Všechny metody

Jaký je tento průvodce?

Naposledy aktualizováno 19. listopadu 2026