Aller au contenu

Galaxie Artibox

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

  1. Créez un jeton personnel

    Choisissez ses portées (lire les réservations, écrire les types…). Le jeton commence par rdv_pat_.

  2. Appelez l'API

    Envoyez le jeton dans l'en-tête x-api-key. Hors de ses portées, l'appel est refusé.

  3. Abonnez-vous aux événements

    Déclarez une adresse de webhook et les événements qui vous intéressent.

  4. 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