L'API prise de rendez-vous ouverte à tous vos outils
Jetons à portées, webhooks signés, applications OAuth, Zapier et Make. Vos réservations circulent là où vous travaillez.
Une API prise de rendez-vous sert dès que vos réservations doivent vivre ailleurs que dans l'outil de réservation : un logiciel métier, un extranet client, un entrepôt de données, un outil d'automatisation. Sans elle, il ne reste que l'export à la main et la ressaisie.
Pourquoi une API prise de rendez-vous complète
Artibox Calendar expose une API REST publique sur ses routes /api/v1 : types de rendez-vous, disponibilités, réservations, sondages, liens uniques, envois de liens, webhooks. Elle passe par les mêmes règles que l'application : les mêmes droits, le même isolement entre organisations, la même réservation sous verrou. Ce qu'un jeton peut faire, son membre peut le faire ; rien de plus.
Pour les équipes sans développeur, les connecteurs Zapier et Make relient vos rendez-vous à vos outils sans écrire de code. Et pour HubSpot, Salesforce ou Pipedrive, les intégrations CRM sont déjà prêtes.
Comment ça marche
Créez un jeton personnel
Choisissez ses portées (lire les réservations, écrire les types…). Le jeton commence par rdv_pat_.
Appelez l'API
Envoyez le jeton dans l'en-tête x-api-key. Hors de ses portées, l'appel est refusé.
Abonnez-vous aux événements
Déclarez une adresse de webhook et les événements qui vous intéressent.
Suivez les livraisons
Le journal des webhooks montre chaque envoi ; vous pouvez tester et rejouer.
Une API pensée pour la production
Des jetons à portées
Chaque jeton personnel porte des portées précises : lire l'utilisateur, lire ou administrer l'organisation, lire ou écrire les types, lire les disponibilités, lire ou écrire les réservations, écrire les liens, gérer les webhooks. Un appel hors portée reçoit une réponse 403. Un jeton ne peut jamais créer un autre jeton.
Des limites claires
Chaque jeton peut faire 100 appels par minute. Les listes sont paginées par numéro de page. Les créations acceptent un en-tête Idempotency-Key, gardé 24 heures : un appel rejoué après une coupure réseau ne crée pas de doublon. Les rendez-vous créés par l'API portent l'origine « api ».
Le même moteur que la page de réservation
Une réservation créée par l'API suit les mêmes règles que sur votre page de réservation en ligne : préavis, marges, maximum par jour, agendas connectés. Si le créneau vient d'être pris, la réponse est un refus clair, jamais une double réservation.
Des webhooks signés
Les événements
Votre application est prévenue quand un rendez-vous est créé, déplacé, annulé ou constaté, quand un invité vote à un sondage ou qu'un sondage est confirmé, et quand un type change. Chaque envoi est signé (en-tête X-Signature) : vous vérifiez qu'il vient bien d'Artibox Calendar.
Des livraisons fiables
Si votre serveur ne répond pas, la livraison est réessayée, d'une minute à douze heures. Après 20 échecs consécutifs, l'abonnement est désactivé. Le journal garde 30 jours de livraisons ; un bouton envoie un événement de test, un autre rejoue une livraison. Pour la sécurité, les webhooks ne peuvent pas viser une adresse du réseau interne.
OAuth pour les éditeurs de logiciels
Vous développez un outil utilisé par d'autres organisations ? Déclarez une application OAuth dans Réglages › Intégrations. Vos utilisateurs voient un écran de consentement, puis votre application reçoit un code à usage unique, valable 10 minutes, protégé par PKCE (S256). Le jeton d'accès vit 2 heures ; le jeton de rafraîchissement tourne à chaque usage, et sa réutilisation coupe tout l'accès. Chaque membre retire un accès depuis « Applications connectées ».
Sans code : Zapier, Make et le widget
Zapier et Make
Les connecteurs Zapier et Make se branchent comme des applications OAuth : déclenchez un scénario à chaque nouveau rendez-vous, envoyez un lien de réservation depuis un autre outil, recherchez un rendez-vous par courriel.
Le kit d'intégration
Le script widget.js ajoute un bouton ou un lien de réservation à votre site. La réservation s'ouvre dans une fenêtre à part. Les paramètres de suivi (utm_*, gclid, fbclid, ref) sont conservés sur le rendez-vous, et un contexte signé peut préremplir la réservation depuis votre outil.
Formules et sécurité
L'API (jetons personnels, applications OAuth) et les connecteurs Zapier et Make font partie de la formule Pro ; les webhooks, de la formule Équipe. Le détail est sur la page tarifs. Seule l'empreinte des jetons est conservée, jamais le jeton en clair : voir sécurité et RGPD.
Pour démarrer, suivez l'aide API et jetons et webhooks. Pour choisir entre les deux outils d'automatisation, lisez Zapier ou Make. Définitions : API, webhook.
Pour qui
Équipes commerciales
Relier les rendez-vous à vos outils de vente et de reporting.
Agences
Intégrer la prise de rendez-vous aux sites et aux outils de vos clients.
Recrutement
Créer les entretiens depuis votre logiciel de suivi des candidats.
Formateurs
Envoyer les inscriptions aux séances vers votre outil de gestion de formation.
Questions fréquentes
Comment s'authentifier sur l'API prise de rendez-vous ?
Avec un jeton personnel (rdv_pat_…) ou un jeton d'accès OAuth, envoyé dans l'en-tête x-api-key. Chaque jeton a ses portées.
Quelles sont les limites d'appels ?
100 appels par minute et par jeton. Les créations acceptent un en-tête Idempotency-Key, gardé 24 heures.
Comment vérifier qu'un webhook vient bien d'Artibox Calendar ?
Chaque envoi est signé dans l'en-tête X-Signature. Vérifiez la signature avant de traiter le contenu.
Que se passe-t-il si mon serveur est indisponible ?
La livraison est réessayée d'une minute à douze heures. Après 20 échecs, l'abonnement est désactivé ; vous pouvez rejouer les livraisons depuis le journal, gardé 30 jours.
Dans quelle formule l'API est-elle incluse ?
L'API, Zapier et Make dès la formule Pro ; les webhooks dès la formule Équipe. Voir les tarifs.
Branchez vos rendez-vous sur vos outils
Créez votre compte gratuitement, puis votre premier jeton d'API.
Créer mon compte