Sari la conținut

Calendar

Programul tău, pagini de rezervare și servicii.

Deschide Calendar
Verificat față de tabloul de bord la 19 noiembrie 2026

Calendar are metode publice pentru cele două părți ale unei rezervări. Unele acționează pentru tine, proprietarul, și iau cheia ta API: îți citesc configurarea și rezervările, configurează resurse, servicii și pagini, rețin și confirmă o oră, anulează și schimbă planul. Altele sunt cele pe care le face o pagină de rezervare pentru un vizitator. Nu au nevoie de cheie, doar de cheia paginii.

Partajarea calendarelor cu alți oameni, vizualizările, sarcinile, evenimentele de zi și Setările Calendar se fac în dashboard. Nu au nicio metodă publică în prezent.

Trimite o cerere către o metodă cu cheia ta:

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

Un răspuns bun are code 1. O schimbare pe care planul tău nu o include este refuzată cu code -62 și o propoziție în data, de exemplu că sesiunile de grup au nevoie de Growth sau că planul tău include un anumit număr de pagini de rezervare. Ca să acționezi pe calendarul unui cont care l-a partajat cu tine la nivel de editare, dă share_id metodelor care îl primesc.

Citește configurarea și rezervările

  • get_calendar_setup răspunde într-un singur apel cu tot ce desenează ecranele Calendar: persoanele și camerele care pot fi rezervate, cu orele lor, serviciile și paginile de rezervare publicate, cu adresele lor publice.
  • get_calendar_bookings listează rezervările, implicit pe cele viitoare. Dă past setat pe true pentru cele care au avut deja loc, cele mai noi primele, și limit pentru câte. Fiecare rând poartă ora în fusul resursei, datele invitatului și orice a spus la rezervare.
  • get_calendar_slots listează orele rezervabile ale unui serviciu pe o resursă între from_ts și to_ts (milisecunde epoch), cu tot ce este deja ocupat lăsat deoparte.

Configurează ce se poate rezerva

  • save_calendar_resource creează sau actualizează ceva ce poate fi rezervat: o persoană, o cameră, un scaun sau un dispozitiv. Are nevoie de un timezone, un fus IANA precum Asia/Jerusalem, iar orele lui se citesc în acel fus. Omite resource_id pentru a crea una nouă.
  • save_calendar_service creează sau actualizează ce pot rezerva oamenii: durata, pauzele, preavizul, cât de devreme poate fi rezervat, locurile, unde are loc (meeting_kind) și, cu price_cents, currency și checkout, cât costă și dacă se plătește la rezervare. Mai mult de un loc are nevoie de un plan care include sesiuni de grup, iar încasarea plății are nevoie de un plan care include plăți.
  • save_calendar_page creează sau actualizează o pagină de rezervare: title, intro, service_ids pe care le oferă, dacă este enabled, culoarea accent, bg_color și text_color (fiecare #rrggbb, sau gol ca pagina să le deducă din accent), show_host, dacă vizitatorii își pot schimba rezervarea (visitor_changes, change_hours, refund_percent) și contul financiar în care se plătește (finance_account_id). Crearea unei pagini peste limita de pagini a planului tău este refuzată.
  • delete_calendar_item elimină o resursă, un serviciu sau o pagină după item_id. Rezervările nu se șterg niciodată astfel: se anulează.

Rezervă tu o oră

Rezervarea din propriul cod se face în doi pași, ca o oră să nu fie vândută de două ori.

Reține ora

hold_calendar_slot rezervă o oră pentru câteva minute. Dă resource_id, service_id și start_utc (milisecunde epoch). Un răspuns bun are data cu occ_id, hold_token și expires_at. Trimite un idem_key ca o repetare a apelului să returneze aceeași reținere în loc să ia un al doilea loc.

Confirmă-o

confirm_calendar_booking transformă reținerea într-o rezervare. Dă occ_id și hold_token din reținere, precum și name, email, phone și note ale invitatului. O reținere care nu mai există a pierdut ora și este refuzată.

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

Schimbă o rezervare

  • cancel_calendar_booking anulează după booking_id și pune ora înapoi pe grila publică. Poate fi apelată de două ori în siguranță. Doar eliberează ora: nu trimite e-mail invitatului și nu rambursează o plată, ceea ce face Anulează programarea din dashboard pentru un invitat care a rezervat prin pagina ta.
  • notify_calendar_guests trimite e-mail tuturor celor invitați la o rezervare, un mesaj fiecăruia, cu invitația de calendar atașată și un message opțional de până la 2000 de caractere. kind este invite pentru o programare nouă și update pentru o schimbare, care este valoarea implicită. E-mailul vine din propria ta căsuță pe un plan care o include și din adresa de rezervări a Xuda în caz contrar, cu adresa ta ca reply-to.
  • create_booking_room creează camera Xuda Meet a unei rezervări video confirmate care nu are una și trimite fiecărui invitat linkul.

Ce apelează o pagină de rezervare

O pagină de rezervare funcționează cu cheia ei de pagină, <uid>.<page_id>, și fără cont.

  • get_booking_bootstrap răspunde cu ce are nevoie o pagină ca să se deseneze: titlul, serviciile și un token anti-bot proaspăt.
  • get_public_booking_slots listează orele pe care le poate alege un vizitator, fiecare cu un început, un sfârșit și un număr de locuri. Nu spune niciodată cine ocupă celelalte locuri.
  • public_book_slot primește o rezervare de la un vizitator. Dă page_key, service_id, start_utc, token, precum și name și email ale vizitatorului. Adaugă un idem_key ca o dublă apăsare să nu rezerve de două ori. company_website este o capcană pentru roboți: lasă-l gol.
  • Pentru un serviciu care se plătește la rezervare, public_start_paid_booking reține ora și începe plata, start_booking_payment trimite o oră reținută la Stripe, iar public_confirm_paid_booking și confirm_paid_booking o rezervă după ce plata s-a încheiat. Plata este citită înapoi din Stripe înainte să se rezerve ceva.
  • Un vizitator își gestionează rezervarea din linkul privat din e-mailul lui. get_public_booking, public_cancel_booking și public_reschedule_booking primesc cheia paginii și valoarea manage a acelui link. Urmează regulile paginii: dacă vizitatorii pot schimba o rezervare și cu cel mult câte ore înainte de începerea ei. O rezervare plătită se rambursează mai întâi, cu procentul de rambursare al paginii.

Planul

get_calendar_plans răspunde cu cele patru niveluri, cu prețurile și ce poartă fiecare, în ce plan ești și dacă Calendar este pornit. calendar_set_plan îl pornește, schimbă nivelul sau îl oprește: dă plan_id ca calendar_free, calendar_starter, calendar_growth sau calendar_business, sau setează deactivate pe true. Vezi Planuri și facturare.

Toate metodele

Cum ți se pare acest ghid?

Ultima actualizare: 19 noiembrie 2026