Aller au contenu

Galaxie Artibox

Réunions ponctuelles · Référence de l'API

Des rendez-vous à créneaux choisis, proposés une fois à un invité.

Lister les réunions ponctuelles

GET/one-off-meetings

Portée : types:lire Lire les types de rendez-vous, leurs créneaux et leurs messages

Ceux que l'appelant peut modifier (les siens ; tous pour un superviseur ou un propriétaire), du plus récent au plus ancien. Jeton : portée `types:lire`. Sans `page` ni `limit`, une liste simple ; avec, `{items, pagination}`.

Liste entière par défaut ; avec page ou limit, paginée (25 par défaut, 500 au plus).

Paramètres

NomOùTypeObligatoireDescription
pagerequêteintegernon
limitrequêteintegernon
pagerequêteintegernonNuméro de page, à partir de 1
limitrequêteintegernonÉléments par page (500 au plus)
Exemple de requête
curl -X GET 'https://www.artibox-calendar.com/api/v1/one-off-meetings' \
  -H "x-api-key: $RDV_TOKEN"

Réponses

  • 200 Réussi
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 422 Données refusées : le détail est donné champ par champ
  • 429 Trop d'appels : attendez Retry-After

Créer une réunion ponctuelle (créneaux choisis, lien à usage unique)

POST/one-off-meetings

Portée : types:ecrire Créer, modifier et supprimer les types de rendez-vous

Un type caché, ouvert par un lien unique, réservable une fois : soit quelques débuts choisis (`slots`, 1 à 20, chacun encore libre), soit les heures de l'organisateur dans une période (`window`). Réservé, il se ferme ; après `expires_at`, le lien répond 410. L'adresse n'est donnée qu'ici. Formule Pro (lien unique). Jeton : portée `types:ecrire`.

Création : l'en-tête Idempotency-Key évite un doublon pendant 24 heures.

Paramètres

NomOùTypeObligatoireDescription
Idempotency-Keyen-têtestringnonUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Corps de la requête

Exemple de requête
curl -X POST 'https://www.artibox-calendar.com/api/v1/one-off-meetings' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{"name":"Point projet","duration_minutes":45,"mode":"video","slots":["2026-12-01T10:00:00+01:00","2026-12-02T15:00:00+01:00"],"expires_at":"2026-12-15T00:00:00+01:00"}'

Réponses

  • 201 Créé
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 409 Conflit : créneau pris ou requête en cours
  • 422 Données refusées : le détail est donné champ par champ
  • 429 Trop d'appels : attendez Retry-After

Lire une réunion ponctuelle

GET/one-off-meetings/{id}

Portée : types:lire Lire les types de rendez-vous, leurs créneaux et leurs messages

Jeton : portée `types:lire`. L'adresse de réservation n'est plus donnée (seulement à la création).

Paramètres

NomOùTypeObligatoireDescription
idcheminstring (uuid)oui
Exemple de requête
curl -X GET 'https://www.artibox-calendar.com/api/v1/one-off-meetings/{id}' \
  -H "x-api-key: $RDV_TOKEN"

Réponses

  • 200 Réussi
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 422 Données refusées : le détail est donné champ par champ
  • 429 Trop d'appels : attendez Retry-After

Supprimer une réunion ponctuelle et retirer son lien

DELETE/one-off-meetings/{id}

Portée : types:ecrire Créer, modifier et supprimer les types de rendez-vous

Son lien n'ouvre plus rien ; un rendez-vous déjà pris reste, détaché. Jeton : portée `types:ecrire`.

Paramètres

NomOùTypeObligatoireDescription
idcheminstring (uuid)oui
Exemple de requête
curl -X DELETE 'https://www.artibox-calendar.com/api/v1/one-off-meetings/{id}' \
  -H "x-api-key: $RDV_TOKEN"

Réponses

  • 204 Fait, sans contenu
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 429 Trop d'appels : attendez Retry-After