Gå til indhold

Kalender

Din kalender, bookingsider og tjenester.

Åbn Kalender
Kontrolleret mod dashboardet den 19. november 2026

Calendar har offentlige metoder til bookingens to sider. Nogle handler for dig, ejeren, og tager din API-nøgle: de læser din opsætning og dine bookinger, sætter ressourcer, tjenester og sider op, reserverer og bekræfter et tidspunkt, aflyser og skifter plan. Andre er dem, en bookingside foretager for en besøgende. De kræver ingen nøgle, kun sidens nøgle.

Deling af kalendere med andre, visningerne, opgaver, dagsbegivenheder og Kalenderindstillinger sker i dashboardet. De har ingen offentlig metode i dag.

Send en anmodning til en metode med din nøgle:

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

Et godt svar har code 1. En ændring, din plan ikke indeholder, afvises med code -62 og en sætning i data, for eksempel at gruppesessioner kræver Growth, eller at din plan rummer et bestemt antal bookingsider. For at handle på kalenderen hos en konto, der delte den med dig på redigeringsniveau, sender du dens share_id til de metoder, der tager en.

Læs din opsætning og dine bookinger

  • get_calendar_setup svarer med alt, hvad Calendar-skærmbillederne tegner, i ét kald: de personer og rum, der kan bookes, med deres åbningstider, tjenesterne og de udgivne bookingsider med deres offentlige adresser.
  • get_calendar_bookings lister bookinger, som standard de kommende. Send past sat til true for dem, der allerede er sket, nyeste først, og limit for hvor mange. Hver række har tidspunktet i ressourcens zone, gæstens oplysninger og alt, vedkommende sagde ved bookingen.
  • get_calendar_slots lister de tidspunkter, en tjeneste kan bookes på hos én ressource mellem from_ts og to_ts (epoch-millisekunder), med alt, der allerede er taget, udeladt.

Sæt op, hvad der kan bookes

  • save_calendar_resource laver eller opdaterer noget, der kan bookes: en person, et rum, en stol eller en enhed. Den kræver en timezone, en IANA-zone som Asia/Jerusalem, og dens åbningstider læses i den zone. Udelad resource_id for at lave en ny.
  • save_calendar_service laver eller opdaterer det, folk kan booke: længde, buffere, varsel, hvor langt frem det kan bookes, pladser, hvor det foregår (meeting_kind), og med price_cents, currency og checkout hvad det koster, og om det betales ved booking. Mere end én plads kræver en plan med gruppesessioner, og at tage betaling kræver en plan med betalinger.
  • save_calendar_page laver eller opdaterer en bookingside: dens title, intro, de service_ids, den tilbyder, om den er enabled, dens accent-farve, dens bg_color og text_color (hver #rrggbb, eller tom, så siden laver den ud fra accenten), show_host, om besøgende kan ændre deres booking (visitor_changes, change_hours, refund_percent) og den finanskonto, der betales ind på (finance_account_id). At lave en side ud over din plans sidegrænse afvises.
  • delete_calendar_item fjerner en ressource, en tjeneste eller en side via item_id. Bookinger slettes aldrig på denne måde: de aflyses.

Book et tidspunkt selv

At booke fra din egen kode er to trin, så ét tidspunkt aldrig sælges to gange.

Reserver tidspunktet

hold_calendar_slot reserverer et tidspunkt i nogle få minutter. Send resource_id, service_id og start_utc (epoch-millisekunder). Et godt svar har data med occ_id, hold_token og expires_at. Send en idem_key, så en gentagelse af kaldet returnerer den samme reservation i stedet for at tage en ekstra plads.

Bekræft det

confirm_calendar_booking gør reservationen til en booking. Send occ_id og hold_token fra reservationen og gæstens name, email, phone og note. En reservation, der ikke findes mere, har mistet tidspunktet og afvises.

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

Ret en booking

  • cancel_calendar_booking aflyser via booking_id og lægger tidspunktet tilbage på det offentlige gitter. Den er sikker at kalde to gange. Den frigiver kun tidspunktet: den sender ikke e-mail til gæsten og refunderer ikke en betaling, hvilket dashboardets Aflys aftale gør for en gæst, der bookede gennem din side.
  • notify_calendar_guests sender e-mail til alle, der er inviteret til én booking, én besked hver, med kalenderinvitationen vedhæftet og en valgfri message på op til 2000 tegn. kind er invite for en ny aftale og update for en ændring, som er standard. E-mailen kommer fra din egen postkasse på en plan, der indeholder den, og ellers fra Xudas bookingadresse med din adresse som svaradresse.
  • create_booking_room laver Xuda Meet-rummet til en bekræftet videobooking, der ikke har et, og sender hver gæst linket.

Hvad en bookingside kalder

En bookingside arbejder med sin sidenøgle, <uid>.<page_id>, og ingen konto.

  • get_booking_bootstrap svarer med det, en side skal bruge for at tegne sig selv: dens titel, dens tjenester og et frisk anti-bot-token.
  • get_public_booking_slots lister de tidspunkter, en besøgende kan vælge, hver med en start, en slut og et antal pladser. Den siger aldrig, hvem der har de andre pladser.
  • public_book_slot tager imod en booking fra en besøgende. Send page_key, service_id, start_utc, token og den besøgendes name og email. Tilføj en idem_key, så et dobbelt tryk ikke booker to gange. company_website er en fælde for bots: lad den stå tom.
  • For en tjeneste, der betales ved booking, reserverer public_start_paid_booking tidspunktet og starter betalingen, start_booking_payment sender et reserveret tidspunkt til Stripe, og public_confirm_paid_booking og confirm_paid_booking booker det, når betalingen er gået igennem. Betalingen læses tilbage fra Stripe, før noget bookes.
  • En besøgende styrer en booking fra det private link i sin e-mail. get_public_booking, public_cancel_booking og public_reschedule_booking tager sidenøglen og det links manage-værdi. De følger sidens regler: om besøgende må ændre en booking, og op til hvor mange timer før den starter. En betalt booking refunderes først, med sidens refusionsprocent.

Planen

get_calendar_plans svarer med de fire niveauer med deres priser og hvad hvert rummer, hvilken plan du er på, og om Calendar er slået til. calendar_set_plan slår det til, skifter niveau eller slår det fra: send plan_id som calendar_free, calendar_starter, calendar_growth eller calendar_business, eller sæt deactivate til true. Se Planer og fakturering.

Alle metoderne

Hvordan er denne guide?

Sidst opdateret den 19. november 2026