Proposer des dates, suivre les votes, confirmer une date.
Lister les sondages
GET/polls
Portée : reservations:lireLire les rendez-vous et les sondages
Les siens, ou tous avec `bookings.all`. Sans `page` ni `limit`, les 100 plus récents en liste simple ; avec, tous, paginés `{items, pagination}`. Jeton : portée `reservations:lire`.
Liste entière par défaut ; avec page ou limit, paginée (25 par défaut, 500 au plus).
Paramètres
Nom
Où
Type
Obligatoire
Description
page
requête
integer
non
limit
requête
integer
non
page
requête
integer
non
Numéro de page, à partir de 1
limit
requête
integer
non
Éléments par page (500 au plus)
Exemple de requête
curl -X GET 'https://www.artibox-calendar.com/api/v1/polls' \
-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 un sondage de dates
POST/polls
Portée : reservations:ecrireCréer, déplacer, annuler et constater les rendez-vous ; gérer les sondages
Création : l'en-tête Idempotency-Key évite un doublon pendant 24 heures.
Paramètres
Nom
Où
Type
Obligatoire
Description
Idempotency-Key
en-tête
string
non
Une 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.
422 Données refusées : le détail est donné champ par champ
429 Trop d'appels : attendez Retry-After
Lire un sondage et ses votes
GET/polls/{id}
Portée : reservations:lireLire les rendez-vous et les sondages
Paramètres
Nom
Où
Type
Obligatoire
Description
id
chemin
string
oui
Exemple de requête
curl -X GET 'https://www.artibox-calendar.com/api/v1/polls/{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
Confirmer une date du sondage (crée le rendez-vous)
POST/polls/{id}/confirm
Portée : reservations:ecrireCréer, déplacer, annuler et constater les rendez-vous ; gérer les sondages
Création : l'en-tête Idempotency-Key évite un doublon pendant 24 heures.
Paramètres
Nom
Où
Type
Obligatoire
Description
id
chemin
string
oui
Idempotency-Key
en-tête
string
non
Une 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
`{start}` — un des créneaux du sondage ; 409 s'il n'est plus libre
422 Données refusées : le détail est donné champ par champ
429 Trop d'appels : attendez Retry-After
Clore un sondage
POST/polls/{id}/close
Portée : reservations:ecrireCréer, déplacer, annuler et constater les rendez-vous ; gérer les sondages
Création : l'en-tête Idempotency-Key évite un doublon pendant 24 heures.
Paramètres
Nom
Où
Type
Obligatoire
Description
id
chemin
string
oui
Idempotency-Key
en-tête
string
non
Une 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.