Hoppa till innehållet

Kalender

Ditt schema, bokningssidor och tjänster.

Öppna Kalender
Kontrollerad mot instrumentpanelen den 19 november 2026

Calendar har publika metoder för bokningens två sidor. Några agerar för dig, ägaren, och tar din API-nyckel: de läser din uppsättning och dina bokningar, ställer in resurser, tjänster och sidor, reserverar och bekräftar en tid, avbokar och ändrar planen. Andra är de som en bokningssida gör för en besökare. De behöver ingen nyckel, bara sidans nyckel.

Att dela kalendrar med andra, vyerna, uppgifter, daghändelser och Kalenderinställningar görs i dashboarden. De har ingen publik metod i dag.

Skicka en begäran till en metod med din nyckel:

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

Ett bra svar har code 1. En ändring som din plan inte inkluderar nekas med code -62 och en mening i data, till exempel att gruppsessioner kräver Growth eller att din plan rymmer ett visst antal bokningssidor. För att agera på kalendern för ett konto som delat den med dig på redigeringsnivå skickar du dess share_id till metoderna som tar en.

Läs din uppsättning och dina bokningar

  • get_calendar_setup svarar med allt som Calendar-skärmarna ritar i ett enda anrop: personerna och rummen som kan bokas med sina tider, tjänsterna och de publicerade bokningssidorna med sina publika adresser.
  • get_calendar_bookings listar bokningar, kommande som standard. Ange past satt till true för de som redan har ägt rum, nyaste först, och limit för hur många. Varje rad bär tiden i resursens zon, gästens uppgifter och allt de sa när de bokade.
  • get_calendar_slots listar de bokningsbara tiderna för en tjänst på en resurs mellan from_ts och to_ts (epok-millisekunder), med allt som redan är taget utelämnat.

Ställ in vad som kan bokas

  • save_calendar_resource skapar eller uppdaterar något som kan bokas: en person, ett rum, en stol eller en enhet. Den kräver en timezone, en IANA-zon som Asia/Jerusalem, och dess tider läses i den zonen. Utelämna resource_id för att skapa en ny.
  • save_calendar_service skapar eller uppdaterar vad folk kan bokas: dess längd, buffertar, framförhållning, hur långt framåt den kan bokas, platser, var den möts (meeting_kind) och, med price_cents, currency och checkout, vad den kostar och om den betalas vid bokning. Mer än en plats kräver en plan som inkluderar gruppsessioner, och att ta betalt kräver en plan som inkluderar betalningar.
  • save_calendar_page skapar eller uppdaterar en bokningssida: dess title, intro, de service_ids den erbjuder, om den är enabled, dess accent-färg, dess bg_color och text_color (var och en #rrggbb, eller tom för att låta sidan göra den utifrån accenten), show_host, om besökare kan ändra sin bokning (visitor_changes, change_hours, refund_percent) och finanskontot den betalas in på (finance_account_id). Att skapa en sida över din plans sidgräns nekas.
  • delete_calendar_item tar bort en resurs, en tjänst eller en sida med item_id. Bokningar tas aldrig bort på det här sättet: de avbokas.

Boka en tid själv

Att boka från din egen kod är två steg, så att en tid aldrig säljs två gånger.

Reservera tiden

hold_calendar_slot reserverar en tid i några minuter. Ange resource_id, service_id och start_utc (epok-millisekunder). Ett bra svar har data med occ_id, hold_token och expires_at. Skicka en idem_key så att en upprepning av anropet ger samma reservation i stället för att ta en andra plats.

Bekräfta den

confirm_calendar_booking gör reservationen till en bokning. Ange occ_id och hold_token från reservationen, och gästens name, email, phone och note. En reservation som inte finns kvar har tappat tiden och nekas.

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

Ändra en bokning

  • cancel_calendar_booking avbokar med booking_id och lägger tillbaka tiden i det publika rutnätet. Det är säkert att anropa två gånger. Den frigör bara tiden: den mejlar inte gästen och återbetalar ingen betalning, vilket dashboardens Avboka mötet gör för en gäst som bokade genom din sida.
  • notify_calendar_guests mejlar alla som är inbjudna till en bokning, ett meddelande var, med kalenderinbjudan bifogad och ett valfritt message på upp till 2000 tecken. kind är invite för ett nytt möte och update för en ändring, vilket är standard. Mejlet kommer från din egen brevlåda på en plan som inkluderar det, och annars från Xudas bokningsadress, med din adress som svarsadress.
  • create_booking_room skapar Xuda Meet-rummet för en bekräftad videobokning som saknar ett, och skickar länken till varje gäst.

Vad en bokningssida anropar

En bokningssida fungerar med sin sidnyckel, <uid>.<page_id>, och inget konto.

  • get_booking_bootstrap svarar med det en sida behöver för att rita sig själv: dess titel, dess tjänster och en färsk anti-bot-token.
  • get_public_booking_slots listar tiderna som en besökare kan välja, var och en med en start, ett slut och ett antal platser. Den säger aldrig vem som har de andra platserna.
  • public_book_slot tar emot en bokning från en besökare. Ange page_key, service_id, start_utc, token och besökarens name och email. Lägg till en idem_key så att ett dubbeltryck inte bokar två gånger. company_website är en fälla för botar: lämna det tomt.
  • För en tjänst som betalas vid bokning reserverar public_start_paid_booking tiden och startar betalningen, start_booking_payment skickar en reserverad tid till Stripe, och public_confirm_paid_booking och confirm_paid_booking bokar den när betalningen har gått igenom. Betalningen läses tillbaka från Stripe innan något bokas.
  • En besökare hanterar en bokning från den privata länken i sitt mejl. get_public_booking, public_cancel_booking och public_reschedule_booking tar sidnyckeln och den länkens manage-värde. De följer sidans regler: om besökare får ändra en bokning och upp till hur många timmar före start. En betald bokning återbetalas först, med sidens återbetalningsprocent.

Planen

get_calendar_plans svarar med de fyra nivåerna med sina priser och vad var och en bär, vilken plan du har och om Calendar är påslaget. calendar_set_plan slår på det, byter nivå eller slår av det: ange plan_id som calendar_free, calendar_starter, calendar_growth eller calendar_business, eller sätt deactivate till true. Se Planer och fakturering.

Alla metoder

Hur är den här guiden?

Senast uppdaterad den 19 november 2026