Aller au contenu

Calendar

Votre agenda, vos pages de réservation et vos services.

Ouvrir Calendar
Vérifié par rapport au tableau de bord le 19 novembre 2026

Calendrier a des méthodes publiques pour les deux côtés d'une réservation. Certaines agissent pour vous, le propriétaire, et prennent votre clé d'API : elles lisent votre configuration et vos réservations, configurent ressources, services et pages, bloquent et confirment un horaire, annulent, et changent le forfait. D'autres sont celles qu'une page de réservation appelle pour un visiteur. Elles n'ont pas besoin de clé, seulement de la clé de la page.

Le partage de calendriers avec d'autres personnes, les vues, les tâches, les événements journée et les Paramètres du Calendrier se font dans le tableau de bord. Ils n'ont aucune méthode publique aujourd'hui.

Envoyez une requête à une méthode avec votre clé :

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

Une bonne réponse a code 1. Un changement que votre forfait n'inclut pas est refusé avec code -62 et une phrase dans data, par exemple que les séances de groupe demandent Growth ou que votre forfait contient un certain nombre de pages de réservation. Pour agir sur le calendrier d'un compte qui l'a partagé avec vous au niveau modification, passez son share_id aux méthodes qui en prennent un.

Lire votre configuration et vos réservations

  • get_calendar_setup répond en un seul appel à tout ce que dessinent les écrans de Calendrier : les personnes et les salles réservables avec leurs heures, les services, et les pages de réservation publiées avec leurs adresses publiques.
  • get_calendar_bookings liste les réservations, à venir par défaut. Passez past à true pour celles qui ont déjà eu lieu, les plus récentes en premier, et limit pour le nombre. Chaque ligne porte l'horaire dans le fuseau de la ressource, les coordonnées de l'invité et tout ce qu'il a dit en réservant.
  • get_calendar_slots liste les horaires réservables d'un service sur une ressource entre from_ts et to_ts (millisecondes depuis l'époque), sans ce qui est déjà pris.

Configurer ce qui peut être réservé

  • save_calendar_resource crée ou met à jour quelque chose qui peut être réservé : une personne, une salle, un fauteuil ou un appareil. Il demande un timezone, un fuseau IANA comme Asia/Jerusalem, et ses heures sont lues dans ce fuseau. Omettez resource_id pour en créer une nouvelle.
  • save_calendar_service crée ou met à jour ce que les gens peuvent réserver : sa durée, ses marges, son préavis, combien de temps à l'avance on peut le réserver, les places, où il a lieu (meeting_kind), et, avec price_cents, currency et checkout, ce qu'il coûte et s'il est payé à la réservation. Plus d'une place demande un forfait qui inclut les séances de groupe, et l'encaissement demande un forfait qui inclut les paiements.
  • save_calendar_page crée ou met à jour une page de réservation : son title, son intro, les service_ids qu'elle propose, si elle est enabled, sa couleur accent, show_host, si les visiteurs peuvent modifier leur réservation (visitor_changes, change_hours, refund_percent) et le compte financier sur lequel elle est payée (finance_account_id). Créer une page au-delà de la limite de pages de votre forfait est refusé.
  • delete_calendar_item supprime une ressource, un service ou une page par item_id. Les réservations ne sont jamais supprimées ainsi : elles sont annulées.

Réserver un horaire vous-même

Réserver depuis votre propre code se fait en deux étapes, pour qu'un horaire ne soit jamais vendu deux fois.

Bloquez l'horaire

hold_calendar_slot réserve un horaire pour quelques minutes. Passez resource_id, service_id et start_utc (millisecondes depuis l'époque). Une bonne réponse a un data avec occ_id, hold_token et expires_at. Envoyez une idem_key pour qu'une répétition de l'appel renvoie le même blocage au lieu de prendre une seconde place.

Confirmez-le

confirm_calendar_booking transforme le blocage en réservation. Passez l'occ_id et le hold_token du blocage, ainsi que le name, l'email, le phone et la note de l'invité. Un blocage qui n'existe plus a perdu l'horaire et est refusé.

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

Modifier une réservation

  • cancel_calendar_booking annule par booking_id et remet l'horaire sur la grille publique. On peut l'appeler deux fois sans risque. Il ne fait que libérer l'horaire : il n'envoie pas d'e-mail à l'invité et ne rembourse aucun paiement, ce que fait Annuler le rendez-vous du tableau de bord pour un invité qui a réservé via votre page.
  • notify_calendar_guests envoie un e-mail à toutes les personnes invitées à une réservation, un message chacune, avec l'invitation de calendrier jointe et un message facultatif de 2000 caractères au plus. kind vaut invite pour un nouveau rendez-vous et update pour une modification, ce qui est la valeur par défaut. L'e-mail part de votre propre boîte mail sur un forfait qui l'inclut, et de l'adresse de réservation de Xuda sinon, avec votre adresse en réponse.
  • create_booking_room crée la salle Xuda Meet d'une réservation vidéo confirmée qui n'en a pas, et envoie le lien à chaque invité.

Ce qu'appelle une page de réservation

Une page de réservation fonctionne avec sa clé de page, <uid>.<page_id>, et sans compte.

  • get_booking_bootstrap répond à ce dont une page a besoin pour se dessiner : son titre, ses services et un jeton anti-robot récent.
  • get_public_booking_slots liste les horaires qu'un visiteur peut choisir, chacun avec un début, une fin et un nombre de places. Elle ne dit jamais qui détient les autres places.
  • public_book_slot prend une réservation d'un visiteur. Passez le page_key, service_id, start_utc, le token, ainsi que le name et l'email du visiteur. Ajoutez une idem_key pour qu'un double appui ne réserve pas deux fois. company_website est un piège pour les robots : laissez-le vide.
  • Pour un service payé à la réservation, public_start_paid_booking bloque l'horaire et démarre le paiement, start_booking_payment envoie un horaire bloqué à Stripe, et public_confirm_paid_booking et confirm_paid_booking le réservent une fois le paiement validé. Le paiement est relu auprès de Stripe avant que quoi que ce soit soit réservé.
  • Un visiteur gère une réservation depuis le lien privé de son e-mail. get_public_booking, public_cancel_booking et public_reschedule_booking prennent la clé de page et la valeur manage de ce lien. Elles suivent les règles de la page : si les visiteurs peuvent modifier une réservation, et jusqu'à combien d'heures avant son début. Une réservation payée est d'abord remboursée, selon le pourcentage de remboursement de la page.

Le forfait

get_calendar_plans répond avec les quatre niveaux, leurs prix et ce que chacun comporte, le forfait que vous avez et si Calendrier est activé. calendar_set_plan l'active, change de niveau ou le désactive : passez plan_id à calendar_free, calendar_starter, calendar_growth ou calendar_business, ou mettez deactivate à true. Voir Forfaits et facturation.

Toutes les méthodes

Que pensez-vous de ce guide ?

Dernière mise à jour le 16 novembre 2026