SOURCE: Vacation Tracker TITLE: Comment utiliser l'API ouverte (OpenAPI) ? URL: https://vacationtracker.io/fr/base-de-connaissances/comment-utiliser-l-api-ouverte-openapi/ LANG: fr PUBLISHED: 2026-10-06 UPDATED: 2026-10-06 READING: 4 min SUMMARY: Créez une clé API dans l'extension API ouverte de Vacation Tracker, choisissez ses autorisations, lisez et modifiez vos données et recevez des webhooks. # Comment utiliser l'API ouverte (OpenAPI) ? # Comment utiliser l'API ouverte (OpenAPI) ? Notre extension API ouverte relie Vacation Tracker à vos propres outils. Créez une clé API, choisissez ce qu'elle peut faire, puis utilisez-la pour lire et modifier vos données ou être averti lorsque quelque chose change. ### Regarder le tutoriel Une courte présentation de l'extension API ouverte : ## Comment créer une clé API - Connectez-vous à votre compte Vacation Tracker sur app.vacationtracker.io/signin (https://app.vacationtracker.io/signin). - Ouvrez Extensions dans le menu de gauche. - Dans l'onglet Mes extensions, trouvez API ouverte et cliquez sur Afficher. Si elle n'y figure pas, trouvez-la dans l'onglet Découvrez plus d'extensions et activez-la d'abord. - Dans la section Clés API, cliquez sur Créer une clé API. - Saisissez un Nom de la clé. Seules les personnes de votre entreprise voient ce nom. - Saisissez éventuellement un Nom de l'intégration. Il s'affiche dans Vacation Tracker à côté de chaque modification effectuée avec la clé, par exemple « Approuvé par Jane (via Payroll sync) ». Laissez-le vide pour n'afficher que le nom de la personne. - Sous Autorisations, choisissez un modèle et ajustez-le si nécessaire (voir ci-dessous). - Sous Expiration, choisissez quand la clé expire : dans 30 jours, dans 90 jours, dans 1 an (recommandé) ou jamais. - Vérifiez le Récapitulatif et cliquez sur Créer une clé API. - Copiez la clé et conservez-la en lieu sûr. La clé complète n'est affichée qu'une seule fois, lors de sa création. ## Choisir les autorisations Partez d'un modèle, puis ajustez-le : - Lecture seule : consulter les données sans rien modifier. Idéal pour les rapports et les tableaux de bord. - Gestion des congés : demander, ajouter et approuver des congés. Lire les utilisateurs et les types de congés. - Configuration de l'espace de travail : configurer les sites, les services, les types de congés, les politiques, les jours fériés et les utilisateurs. - Personnalisé : choisir vous-même chaque autorisation. Chaque autorisation peut être réglée sur Aucun accès, Lecture ou Lecture et écriture. Approuver et refuser des demandes, voir les noms des types de congés masqués et agir au nom d'autres utilisateurs sont des cases à cocher distinctes : ne les activez que si votre outil en a besoin. Une clé ne peut faire que ce que vous êtes autorisé à faire dans Vacation Tracker. ## Gérer vos clés Le tableau Clés API liste toutes les clés de votre espace de travail avec leur propriétaire, leurs autorisations, leur dernière utilisation, leur date d'expiration et leur état. Cliquez sur une clé pour ouvrir ses détails, où vous pouvez : - Voir l'utilisation du mois en cours et modifier le nom et les autorisations de la clé. - Consulter l'Activité récente, qui liste chaque requête ayant modifié des données. - Cliquer sur Renouveler la clé pour obtenir une nouvelle clé avec le même nom et les mêmes autorisations. Choisissez si l'ancienne clé continue de fonctionner pendant 24 heures (recommandé), pendant 7 jours ou cesse de fonctionner immédiatement. - Cliquer sur Révoquer pour désactiver définitivement la clé. Nous vous envoyons un e-mail 14 jours avant l'expiration d'une clé. ## Envoyer votre première requête L'URL de base est https://api.vacationtracker.io/v2. Envoyez votre clé comme jeton bearer dans l'en-tête Authorization : curl https://api.vacationtracker.io/v2/departments \ -H "Authorization: Bearer vt_live_..." Un appel réussi renvoie les données sous data. Les listes comportant plusieurs pages incluent aussi un nextToken, que vous renvoyez pour obtenir la page suivante. { "data": [ ... ], "nextToken": "..." } En cas de problème, la réponse contient une error avec un code, une description et une solution. Une clé absente ou inconnue renvoie le code 401. Une clé qui n'a pas l'autorisation nécessaire à une requête renvoie le code 403 avec INSUFFICIENT_SCOPE. Référence technique complète Tous les endpoints, paramètres, codes d'erreur et événements de webhook figurent dans notre documentation développeur (https://vacationtracker.io/developers/api-v2). Vous pouvez aussi l'ouvrir avec le bouton Ouvrir la documentation sur la page de l'extension API ouverte. ## Comment ajouter un webhook - Sur la page de l'extension API ouverte, allez dans Webhooks et cliquez sur Gérer les webhooks. - Cliquez sur Ajouter un webhook. - Saisissez l'URL du point de terminaison qui doit recevoir les événements. Elle doit utiliser HTTPS. - Sous Événements, choisissez Décisions sur les congés, Toute l'activité liée aux absences, Garder une copie complète synchronisée ou Personnalisé pour choisir vous-même les événements. - Cliquez sur Ajouter un webhook. Vous ne recevez des événements que pour les données que vous êtes autorisé à voir. ## Quotas et limites de débit Les limites s'appliquent par clé API : - Jusqu'à 30 000 requêtes par mois. - 10 requêtes par seconde, avec une pointe pouvant aller jusqu'à 50 requêtes. Si votre intégration a besoin de plus, écrivez à developers@vacationtracker.io (mailto:developers@vacationtracker.io) en indiquant le nom de votre entreprise, l'intégration et le trafic que vous prévoyez. Anciennes clés API Les clés créées avant l'API v2 sont listées sous Clés existantes (API v1). Elles continuent de fonctionner, mais permettent uniquement de lire des données et ne fonctionnent pas avec l'API v2. Pour modifier des données via l'API, créez une nouvelle clé et suivez notre guide de migration (https://vacationtracker.io/developers/api-v2/migration). ## Questions fréquentes Dois-je utiliser l'API, Zapier ou le serveur MCP ? Cela dépend de ce que vous faites. L'API sert à votre propre code et à vos propres outils, avec des webhooks pour réagir aux changements. Zapier est l'option sans code. Le serveur MCP connecte un outil d'IA comme Claude ou ChatGPT pour que vous puissiez poser des questions en langage courant. De nombreuses équipes en utilisent plusieurs. L'API est-elle payante ? Non. L'extension API ouverte est incluse dans les plans Core et Complete sans frais supplémentaires. Que se passe-t-il si je perds une clé ? La clé complète n'est affichée qu'une seule fois et ne peut pas être récupérée. Ouvrez la clé et cliquez sur Renouveler la clé pour en obtenir une nouvelle, puis mettez à jour l'outil qui l'utilise. Si l'ancienne clé a pu fuiter, choisissez de la désactiver immédiatement. ### Pour aller plus loin Comment connecter Vacation Tracker à Zapier ? (https://vacationtracker.io/fr/base-de-connaissances/comment-connecter-vacation-tracker-a-zapier/) Comment connecter Vacation Tracker à mes outils d'IA avec le serveur MCP ? (https://vacationtracker.io/fr/base-de-connaissances/comment-connecter-vacation-tracker-a-mes-outils-d-ia-avec-le-serveur-mcp/) Comment exporter un rapport des demandes de congés (historique des congés) ? (https://vacationtracker.io/fr/base-de-connaissances/comment-exporter-un-rapport-des-demandes-de-conges-historique-des-conges/) Besoin d'aide ? Contactez notre équipe d'assistance par e-mail ou par chat, du lundi au vendredi, de 9 h à 17 h (heure de l'Est).