Przejdź do treści

Kalendarz

Twój grafik, strony rezerwacji i usługi.

Otwórz Kalendarz
Sprawdzono z pulpitem dnia 19 listopada 2026

Calendar ma publiczne metody dla obu stron rezerwacji. Jedne działają dla Ciebie, właściciela, i przyjmują Twój klucz API: odczytują konfigurację i rezerwacje, ustawiają zasoby, usługi i strony, wstrzymują i potwierdzają termin, anulują i zmieniają plan. Inne to te, które strona rezerwacji wykonuje dla odwiedzającego. Nie potrzebują klucza, tylko klucza strony.

Udostępnianie kalendarzy innym osobom, widoki, zadania, wydarzenia dnia i Ustawienia kalendarza odbywają się w dashboardzie. Nie mają dziś metody publicznej.

Wyślij żądanie do metody ze swoim kluczem:

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

Dobra odpowiedź ma code 1. Zmiana, której Twój plan nie obejmuje, jest odrzucana z code -62 i zdaniem w data, na przykład że sesje grupowe wymagają Growth albo że Twój plan mieści określoną liczbę stron rezerwacji. Aby działać na kalendarzu konta, które udostępniło go Tobie z prawem edycji, przekaż jego share_id metodom, które go przyjmują.

Odczytaj konfigurację i rezerwacje

  • get_calendar_setup odpowiada jednym wywołaniem na wszystko, co rysują ekrany Calendar: osoby i pokoje, które można rezerwować, wraz z godzinami, usługi i opublikowane strony rezerwacji z ich publicznymi adresami.
  • get_calendar_bookings wyświetla rezerwacje, domyślnie nadchodzące. Przekaż past ustawione na true, aby dostać te, które już się odbyły, od najnowszych, oraz limit dla liczby. Każdy wiersz niesie czas w strefie zasobu, dane gościa i wszystko, co powiedział przy rezerwacji.
  • get_calendar_slots wyświetla terminy do zarezerwowania jednej usługi na jednym zasobie między from_ts a to_ts (milisekundy epoki), z pominięciem wszystkiego, co już zajęte.

Skonfiguruj to, co można zarezerwować

  • save_calendar_resource tworzy lub aktualizuje coś, co można zarezerwować: osobę, pokój, fotel lub urządzenie. Wymaga timezone, strefy IANA, takiej jak Asia/Jerusalem, a jego godziny są czytane w tej strefie. Pomiń resource_id, aby utworzyć nowy.
  • save_calendar_service tworzy lub aktualizuje to, co ludzie mogą zarezerwować: jego długość, bufory, wyprzedzenie, na ile dni naprzód można rezerwować, miejsca, gdzie się odbywa (meeting_kind) oraz, z price_cents, currency i checkout, ile kosztuje i czy jest płatne przy rezerwacji. Więcej niż jedno miejsce wymaga planu z sesjami grupowymi, a pobieranie płatności wymaga planu z płatnościami.
  • save_calendar_page tworzy lub aktualizuje stronę rezerwacji: jej title, intro, oferowane service_ids, czy jest enabled, jej kolor accent, jej bg_color i text_color (każdy #rrggbb albo pusty, aby strona wyprowadziła go z akcentu), show_host, czy odwiedzający mogą zmieniać swoją rezerwację (visitor_changes, change_hours, refund_percent) i konto finansowe, na które trafiają płatności (finance_account_id). Utworzenie strony ponad limit stron Twojego planu jest odrzucane.
  • delete_calendar_item usuwa zasób, usługę lub stronę według item_id. Rezerwacje nigdy nie są w ten sposób usuwane: są anulowane.

Zarezerwuj termin samodzielnie

Rezerwacja z własnego kodu to dwa kroki, aby jeden termin nigdy nie został sprzedany dwa razy.

Wstrzymaj termin

hold_calendar_slot rezerwuje termin na kilka minut. Przekaż resource_id, service_id i start_utc (milisekundy epoki). Dobra odpowiedź ma data z occ_id, hold_token i expires_at. Wyślij idem_key, aby powtórzenie wywołania zwróciło to samo wstrzymanie zamiast zajmować drugie miejsce.

Potwierdź go

confirm_calendar_booking zamienia wstrzymanie w rezerwację. Przekaż occ_id i hold_token z wstrzymania oraz name, email, phone i note gościa. Wstrzymanie, którego już nie ma, straciło termin i jest odrzucane.

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

Zmień rezerwację

  • cancel_calendar_booking anuluje według booking_id i zwraca termin na publiczną siatkę. Można ją bezpiecznie wywołać dwa razy. Tylko zwalnia termin: nie wysyła e-maila do gościa ani nie zwraca płatności, co robi Anuluj spotkanie w dashboardzie dla gościa, który zarezerwował przez Twoją stronę.
  • notify_calendar_guests wysyła e-mailem do wszystkich zaproszonych na jedną rezerwację, po jednej wiadomości, z załączonym zaproszeniem do kalendarza i opcjonalnym message do 2000 znaków. kind to invite dla nowego spotkania i update dla zmiany, co jest wartością domyślną. E-mail pochodzi z Twojej własnej skrzynki w planie, który ją obejmuje, a w przeciwnym razie z adresu rezerwacji Xuda, z Twoim adresem jako adresem odpowiedzi.
  • create_booking_room tworzy pokój Xuda Meet dla potwierdzonej rezerwacji wideo, która go nie ma, i wysyła każdemu gościowi link.

Co wywołuje strona rezerwacji

Strona rezerwacji działa z kluczem strony, <uid>.<page_id>, i bez konta.

  • get_booking_bootstrap odpowiada tym, czego strona potrzebuje, aby się narysować: jej tytułem, usługami i świeżym tokenem antybotowym.
  • get_public_booking_slots wyświetla terminy, które odwiedzający może wybrać, każdy z początkiem, końcem i liczbą miejsc. Nigdy nie mówi, kto zajmuje pozostałe miejsca.
  • public_book_slot przyjmuje rezerwację od odwiedzającego. Przekaż page_key, service_id, start_utc, token oraz name i email odwiedzającego. Dodaj idem_key, aby dwukrotne naciśnięcie nie zarezerwowało dwa razy. company_website to pułapka na boty: zostaw go pustym.
  • Dla usługi płatnej przy rezerwacji public_start_paid_booking wstrzymuje termin i rozpoczyna płatność, start_booking_payment wysyła wstrzymany termin do Stripe, a public_confirm_paid_booking i confirm_paid_booking rezerwują go po zaksięgowaniu płatności. Płatność jest odczytywana ze Stripe, zanim cokolwiek zostanie zarezerwowane.
  • Odwiedzający zarządza rezerwacją z prywatnego linku w swoim e-mailu. get_public_booking, public_cancel_booking i public_reschedule_booking przyjmują klucz strony i wartość manage z tego linku. Stosują się do reguł strony: czy odwiedzający mogą zmieniać rezerwację i do ilu godzin przed jej początkiem. Płatna rezerwacja jest najpierw zwracana, według procentu zwrotu strony.

Plan

get_calendar_plans odpowiada czterema poziomami z ich cenami i tym, co niesie każdy, jaki plan masz i czy Calendar jest włączony. calendar_set_plan włącza go, zmienia poziom albo wyłącza: przekaż plan_id jako calendar_free, calendar_starter, calendar_growth lub calendar_business albo ustaw deactivate na true. Zobacz Plany i rozliczenia.

Wszystkie metody

Jak oceniasz ten poradnik?

Ostatnia aktualizacja: 19 listopada 2026