Preskočiť na obsah

Kalendár

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

Otvoriť Kalendár
Overené voči nástenke dňa 19. novembra 2026

Calendar má verejné metódy pre obe strany rezervácie. Niektoré konajú za vás, vlastníka, a berú váš API kľúč: čítajú vaše nastavenie a rezervácie, nastavujú zdroje, služby a stránky, zadržia a potvrdia čas, rušia a menia plán. Ostatné sú tie, ktoré robí rezervačná stránka pre návštevníka. Nepotrebujú kľúč, len kľúč stránky.

Zdieľanie kalendárov s inými ľuďmi, zobrazenia, úlohy, celodenné udalosti a Nastavenia kalendára sa robia v dashboarde. Dnes pre ne neexistuje verejná metóda.

Pošlite požiadavku metóde so svojím kľúčom:

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á odpoveď má code 1. Zmena, ktorú váš plán nezahŕňa, sa odmietne s code -62 a vetou v data, napríklad že skupinové relácie potrebujú Growth alebo že váš plán obsahuje určitý počet rezervačných stránok. Ak chcete konať v kalendári účtu, ktorý vám ho zdieľal na úrovni úprav, odovzdajte jeho share_id metódam, ktoré ho berú.

Čítajte nastavenie a rezervácie

  • get_calendar_setup odpovie na všetko, čo obrazovky Calendar kreslia, jedným volaním: osoby a miestnosti, ktoré sa dajú rezervovať, s ich hodinami, služby a zverejnené rezervačné stránky s ich verejnými adresami.
  • get_calendar_bookings vypisuje rezervácie, predvolene nadchádzajúce. Odovzdajte past nastavené na true pre tie, ktoré už prebehli, od najnovších, a limit pre ich počet. Každý riadok nesie čas v pásme zdroja, údaje hosťa a všetko, čo pri rezervácii povedal.
  • get_calendar_slots vypisuje rezervovateľné časy jednej služby na jednom zdroji medzi from_ts a to_ts (epoch v milisekundách), bez všetkého, čo je už obsadené.

Nastavte, čo sa dá rezervovať

  • save_calendar_resource vytvorí alebo aktualizuje niečo, čo sa dá rezervovať: osobu, miestnosť, stoličku alebo zariadenie. Potrebuje timezone, zónu IANA ako Asia/Jerusalem, a jej hodiny sa čítajú v tejto zóne. Vynechajte resource_id, aby ste vytvorili nový.
  • save_calendar_service vytvorí alebo aktualizuje, čo si ľudia môžu rezervovať: jeho dĺžku, rezervy, predstih, ako ďaleko dopredu sa dá rezervovať, miesta, kde sa stretávajú (meeting_kind) a pomocou price_cents, currency a checkout, koľko stojí a či sa platí pri rezervácii. Viac ako jedno miesto vyžaduje plán, ktorý zahŕňa skupinové relácie, a prijímanie platieb vyžaduje plán, ktorý zahŕňa platby.
  • save_calendar_page vytvorí alebo aktualizuje rezervačnú stránku: jej title, intro, service_ids, ktoré ponúka, či je enabled, jej farbu accent, jej bg_color a text_color (každá #rrggbb, alebo prázdna, aby ju stránka odvodila z akcentu), show_host, či návštevníci môžu meniť svoju rezerváciu (visitor_changes, change_hours, refund_percent) a finančný účet, na ktorý sa platí (finance_account_id). Vytvorenie stránky nad limit stránok vášho plánu sa odmietne.
  • delete_calendar_item odstráni zdroj, službu alebo stránku podľa item_id. Rezervácie sa takto nikdy nemažú: rušia sa.

Rezervujte čas sami

Rezervácia z vlastného kódu má dva kroky, aby sa jeden čas nikdy nepredal dvakrát.

Zadržte čas

hold_calendar_slot rezervuje čas na niekoľko minút. Odovzdajte resource_id, service_id a start_utc (epoch v milisekundách). Dobrá odpoveď má data s occ_id, hold_token a expires_at. Pošlite idem_key, aby opakované volanie vrátilo to isté zadržanie namiesto zabratia druhého miesta.

Potvrďte ho

confirm_calendar_booking zmení zadržanie na rezerváciu. Odovzdajte occ_id a hold_token zo zadržania a name, email, phone a note hosťa. Zadržanie, ktoré už neexistuje, stratilo čas a odmietne sa.

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

Zmeňte rezerváciu

  • cancel_calendar_booking zruší podľa booking_id a vráti čas na verejnú mriežku. Je bezpečné zavolať ho dvakrát. Iba uvoľní čas: neposiela hosťovi e-mail ani nevracia platbu, čo robí Zrušiť stretnutie v dashboarde pre hosťa, ktorý rezervoval cez vašu stránku.
  • notify_calendar_guests pošle e-mail všetkým pozvaným na jednu rezerváciu, po jednej správe každému, s kalendárovou pozvánkou v prílohe a voliteľnou message do 2000 znakov. kind je invite pre nové stretnutie a update pre zmenu, čo je predvolené. E-mail prichádza z vašej vlastnej schránky na pláne, ktorý ju zahŕňa, a inak z rezervačnej adresy Xuda, s vašou adresou ako adresou pre odpoveď.
  • create_booking_room vytvorí miestnosť Xuda Meet potvrdenej video rezervácie, ktorá ju nemá, a pošle každému hosťovi odkaz.

Čo volá rezervačná stránka

Rezervačná stránka funguje s kľúčom stránky, <uid>.<page_id>, a bez účtu.

  • get_booking_bootstrap odpovie, čo stránka potrebuje na vykreslenie: jej názov, služby a čerstvý token proti botom.
  • get_public_booking_slots vypisuje časy, ktoré môže návštevník vybrať, každý so začiatkom, koncom a počtom miest. Nikdy nepovie, kto drží ostatné miesta.
  • public_book_slot prijme rezerváciu od návštevníka. Odovzdajte page_key, service_id, start_utc, token a name a email návštevníka. Pridajte idem_key, aby dvojité stlačenie nerezervovalo dvakrát. company_website je pasca na boty: nechajte ho prázdne.
  • Pre službu, ktorá sa platí pri rezervácii, public_start_paid_booking zadrží čas a spustí platbu, start_booking_payment pošle zadržaný čas do Stripe a public_confirm_paid_booking a confirm_paid_booking ho rezervujú, keď platba prebehla. Platba sa prečíta späť zo Stripe skôr, než sa čokoľvek rezervuje.
  • Návštevník spravuje rezerváciu zo súkromného odkazu vo svojom e-maile. get_public_booking, public_cancel_booking a public_reschedule_booking berú kľúč stránky a hodnotu manage z tohto odkazu. Riadia sa pravidlami stránky: či smú návštevníci meniť rezerváciu a do koľkých hodín pred jej začiatkom. Platená rezervácia sa najprv vráti podľa percenta refundácie stránky.

Plán

get_calendar_plans odpovie štyrmi úrovňami s cenami a tým, čo každá nesie, ktorý plán máte a či je Calendar zapnutý. calendar_set_plan ho zapne, zmení úroveň alebo vypne: odovzdajte plan_id ako calendar_free, calendar_starter, calendar_growth alebo calendar_business, alebo nastavte deactivate na true. Pozrite Plány a fakturácia.

Všetky metódy

Aký je tento návod?

Naposledy aktualizované dňa 20. novembra 2026