Aller au contenu
Intégrations

Comment créer un jeton d'API et appeler l'API

Créez un jeton personnel, choisissez ses portées et appelez l'API d'Artibox Calendar depuis vos propres outils, en votre nom.

Par Publié le 3 min de lecture

Cet article s'adresse aux personnes techniques, ou à celles qui transmettent un accès à un développeur. Savoir comment créer un jeton d'API permet de relier Artibox Calendar à un outil maison, un site ou un CRM qui n'a pas de connecteur prêt.

Comment créer un jeton d'API : ce qu'il faut

  • La formule Pro ou plus (tarifs).
  • Être membre de l'organisation : chaque membre crée ses propres jetons. Un jeton agit en votre nom, dans cette organisation, avec les droits de votre rôle.

Créer et utiliser un jeton en six étapes

  1. Ouvrir les intégrations

    Dans le menu, ouvrez Réglages › Intégrations et repérez la carte « API ».

  2. Nommer le jeton

    Dans « Nom du jeton », indiquez l'outil qui l'utilisera, par exemple « Site internet ». Vous le reconnaîtrez dans la liste.

  3. Choisir une date d'expiration

    « Expire le » est facultatif. Vide, le jeton reste valable jusqu'à ce que vous le révoquiez.

  4. Cocher les portées

    Ne cochez que ce dont l'outil a besoin : par exemple « Lire les types » et « Lire les disponibilités » pour afficher des créneaux, « Créer, déplacer, annuler les rendez-vous » pour réserver.

  5. Créer et copier

    Cliquez sur « Créer le jeton ». Copiez-le aussitôt : il ne s'affichera plus. Il commence par rdv_pat_.

  6. Appeler l'API

    Envoyez le jeton dans l'en-tête x-api-key de vos appels aux adresses /api/v1/… de l'application.

Les règles de l'API

  • Portées : un appel hors des portées du jeton est refusé (erreur 403).
  • Limite : 100 appels par minute et par jeton.
  • Créations sans doublon : envoyez un en-tête Idempotency-Key sur une création ; le même appel rejoué dans les 24 heures ne crée rien de plus.
  • Pagination : les listes se lisent page par page, par numéro de page.
  • Origine : un rendez-vous créé par l'API porte la mention « Créé par l'API » sur sa fiche.

Pour être prévenu des changements sans interroger l'API en boucle, ajoutez des webhooks. La présentation générale est sur la page API et webhooks, et la définition d'une API est dans le glossaire.

Pour un éditeur de logiciel : les applications OAuth

Si votre outil doit agir pour d'autres comptes que le vôtre, ne partagez pas de jeton personnel : le propriétaire peut déclarer une application dans la carte « Applications OAuth (éditeur) ». Chaque compte l'autorise ensuite sur l'écran « Autoriser une application ». Voir la définition d'OAuth.

Si quelque chose bloque

J'ai perdu mon jeton. Il n'est jamais réaffiché. Révoquez-le avec « Révoquer », puis créez-en un nouveau.

Mes appels sont refusés. Vérifiez l'en-tête x-api-key, les portées cochées, la date d'expiration, et que vous restez sous 100 appels par minute.

Questions fréquentes

Un jeton voit-il toute l'organisation ?

Non. Il a exactement les droits de votre rôle, limités aux portées cochées. Un membre ne voit que ses propres rendez-vous et ceux de ses types.

Comment savoir si un jeton sert encore ?

La liste indique pour chaque jeton « Utilisé le … » ou « Jamais utilisé ». Révoquez ceux qui ne servent plus.

Reliez vos outils à vos rendez-vous

Créez votre espace, puis votre premier jeton dans Réglages › Intégrations.

Créer mon compte
Cet article vous a-t-il aidé ?

À lire aussi

  • Intégrations

    Configurer un webhook

    Ajoutez un webhook pour que votre application soit prévenue en temps réel d'un rendez-vous créé, déplacé ou annulé, avec un envoi signé.

  • Intégrations

    Connecter Zapier et Make

    Branchez vos rendez-vous à des centaines d'outils sans écrire de code : déclencheurs et actions Artibox Calendar dans vos Zaps et vos scénarios Make.

  • Intégrations

    Connecter HubSpot, Salesforce ou Pipedrive

    Reliez HubSpot, Salesforce ou Pipedrive : chaque rendez-vous crée ou met à jour le contact et ajoute une réunion dans votre CRM, sans double saisie.