Naar de inhoud springen

Agenda

Je planning, boekingspagina's en diensten.

Agenda openen
Gecontroleerd aan de hand van het dashboard op 19 november 2026

Agenda heeft openbare methoden voor de twee kanten van een boeking. Sommige handelen voor jou, de eigenaar, en nemen je API-sleutel: ze lezen je instellingen en je boekingen, stellen resources, diensten en pagina's in, houden een tijd vast en bevestigen hem, annuleren en wijzigen het abonnement. Andere zijn de methoden die een boekingspagina voor een bezoeker doet. Die hebben geen sleutel nodig, alleen de sleutel van de pagina.

Agenda's met andere mensen delen, de weergaven, taken, daggebeurtenissen en Agenda-instellingen doe je in het dashboard. Daar is vandaag geen openbare methode voor.

Stuur een aanvraag met je sleutel naar een methode:

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

Een goed antwoord heeft code 1. Een wijziging die je abonnement niet bevat, wordt geweigerd met code -62 en een zin in data, bijvoorbeeld dat groepssessies Growth nodig hebben of dat je abonnement een aantal boekingspagina's bevat. Om te handelen op de agenda van een account dat hem met jou heeft gedeeld op bewerkingsniveau, geef je zijn share_id mee aan de methoden die er een nemen.

Lees je instellingen en boekingen

  • get_calendar_setup beantwoordt in één aanroep alles wat de Agenda-schermen tekenen: de boekbare mensen en ruimtes met hun uren, de diensten en de gepubliceerde boekingspagina's met hun openbare adressen.
  • get_calendar_bookings toont boekingen, standaard de komende. Geef past op true mee voor de boekingen die al hebben plaatsgevonden, nieuwste eerst, en limit voor hoeveel. Elke rij bevat de tijd in de zone van de resource, de gegevens van de gast en alles wat hij bij het boeken zei.
  • get_calendar_slots toont de boekbare tijden van één dienst op één resource tussen from_ts en to_ts (epoch-milliseconden), waarbij alles wat al bezet is, wordt weggelaten.

Stel in wat er geboekt kan worden

  • save_calendar_resource maakt of werkt iets bij wat geboekt kan worden: een persoon, een ruimte, een stoel of een apparaat. Het heeft een timezone nodig, een IANA-zone zoals Asia/Jerusalem, en de uren worden in die zone gelezen. Laat resource_id weg om een nieuwe te maken.
  • save_calendar_service maakt of werkt bij wat mensen kunnen boeken: de duur, buffers, aanlooptijd, hoe ver vooruit het geboekt kan worden, plaatsen, waar het plaatsvindt (meeting_kind) en, met price_cents, currency en checkout, wat het kost en of het bij het boeken wordt betaald. Meer dan één plaats vraagt om een abonnement dat groepssessies bevat, en betaling innen vraagt om een abonnement dat betalingen bevat.
  • save_calendar_page maakt of werkt een boekingspagina bij: zijn title, intro, de service_ids die hij aanbiedt, of hij enabled is, zijn accent-kleur, zijn bg_color en text_color (elk #rrggbb, of leeg om de pagina ze uit het accent te laten maken), show_host, of bezoekers hun boeking kunnen wijzigen (visitor_changes, change_hours, refund_percent) en het financiële account waarop wordt uitbetaald (finance_account_id). Een pagina maken boven de paginalimiet van je abonnement wordt geweigerd.
  • delete_calendar_item verwijdert een resource, een dienst of een pagina op item_id. Boekingen worden op deze manier nooit verwijderd: ze worden geannuleerd.

Zelf een tijd boeken

Boeken vanuit je eigen code gaat in twee stappen, zodat één tijd nooit twee keer wordt verkocht.

Houd de tijd vast

hold_calendar_slot reserveert een tijd voor een paar minuten. Geef resource_id, service_id en start_utc (epoch-milliseconden) mee. Een goed antwoord heeft data met occ_id, hold_token en expires_at. Stuur een idem_key mee zodat een herhaling van de aanroep dezelfde reservering teruggeeft in plaats van een tweede plaats in te nemen.

Bevestig hem

confirm_calendar_booking maakt van de reservering een boeking. Geef de occ_id en hold_token van de reservering mee, en de name, email, phone en note van de gast. Een reservering die er niet meer is, is de tijd kwijt en wordt geweigerd.

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

Een boeking wijzigen

  • cancel_calendar_booking annuleert op booking_id en zet de tijd terug op het openbare raster. Twee keer aanroepen is veilig. Het geeft alleen de tijd vrij: het mailt de gast niet en betaalt geen betaling terug, wat Afspraak annuleren in het dashboard wel doet voor een gast die via je pagina heeft geboekt.
  • notify_calendar_guests mailt iedereen die voor één boeking is uitgenodigd, elk een eigen bericht, met de agenda-uitnodiging erbij en een optioneel message van maximaal 2000 tekens. kind is invite voor een nieuwe afspraak en update voor een wijziging, wat de standaard is. De e-mail komt van je eigen mailbox op een abonnement dat dit bevat, en anders van het boekingsadres van Xuda, met jouw adres als antwoordadres.
  • create_booking_room maakt de Xuda Meet-ruimte van een bevestigde videoboeking die er geen heeft, en stuurt elke gast de link.

Wat een boekingspagina aanroept

Een boekingspagina werkt met zijn paginasleutel, <uid>.<page_id>, en geen account.

  • get_booking_bootstrap beantwoordt wat een pagina nodig heeft om zichzelf te tekenen: zijn titel, zijn diensten en een vers antibot-token.
  • get_public_booking_slots toont de tijden die een bezoeker kan kiezen, elk met een begin, een einde en een aantal plaatsen. Het zegt nooit wie de andere plaatsen bezet.
  • public_book_slot neemt een boeking aan van een bezoeker. Geef de page_key, service_id, start_utc, het token, en de name en email van de bezoeker mee. Voeg een idem_key toe zodat een dubbele druk niet twee keer boekt. company_website is een val voor bots: laat hem leeg.
  • Voor een dienst die bij het boeken wordt betaald, houdt public_start_paid_booking de tijd vast en start de betaling, stuurt start_booking_payment een vastgehouden tijd naar Stripe, en boeken public_confirm_paid_booking en confirm_paid_booking hem zodra de betaling is gedekt. De betaling wordt bij Stripe teruggelezen voordat er iets wordt geboekt.
  • Een bezoeker beheert een boeking via de privélink in zijn e-mail. get_public_booking, public_cancel_booking en public_reschedule_booking nemen de paginasleutel en de manage-waarde van die link. Ze volgen de regels van de pagina: of bezoekers een boeking mogen wijzigen, en tot hoeveel uur voor het begin. Een betaalde boeking wordt eerst terugbetaald, met het terugbetalingspercentage van de pagina.

Het abonnement

get_calendar_plans beantwoordt de vier niveaus met hun prijzen en wat elk bevat, op welk abonnement je zit en of Agenda aan staat. calendar_set_plan zet het aan, wijzigt het niveau of zet het uit: geef plan_id mee als calendar_free, calendar_starter, calendar_growth of calendar_business, of zet deactivate op true. Zie Abonnementen en facturering.

Alle methoden

Hoe vind je deze gids?

Laatst bijgewerkt op 19 november 2026