L’API Day Off vous permet de connecter de manière transparente vos systèmes avec Day Off et d’automatiser les processus clés. Grâce à elle, vous pouvez accéder et gérer par programmation des données telles que les dossiers des employés, les demandes de congé et les soldes, vous aidant à réduire le travail manuel et à maintenir la synchronisation entre tous vos outils.
Étapes de configuration
1. Accéder à la section API dans Day Off
Commencez par accéder aux paramètres API dans votre compte Day Off.
- Depuis le menu principal, accédez aux Intégrations
- Cliquez sur API
Vous arriverez sur la page de Gestion des clés API. Au début, cette page peut sembler vide, surtout si vous n’avez pas encore créé de clés API. C’est tout à fait normal. Considérez cette page comme votre centre de contrôle pour tout ce qui concerne l’accès à l’API.
2. Créer une nouvelle clé API
Avant de pouvoir vous connecter à l’API, vous devez générer une clé API. Cette clé agit comme un mot de passe sécurisé qui permet à votre système de communiquer avec Day Off.
- Cliquez sur Ajouter une clé API
- Une fenêtre contextuelle apparaîtra
- Entrez un Nom pour votre clé : « Intégration Système RH » ou « Automatisation Zapier »
- Choisissez une Date d’expiration : Cela ajoute une couche de sécurité supplémentaire
- Cliquez sur Ajouter
Une fois créée, votre clé API sera générée.
3. Ouvrir et comprendre la documentation API
Maintenant que vous avez votre clé API, l’étape suivante est de comprendre comment l’utiliser.
- Cliquez sur Documentation
- Cela ouvrira la documentation de l’API Day Off
À l’intérieur, vous trouverez :
- Une liste des points de terminaison disponibles (ce que vous pouvez faire avec l’API)
- Des exemples de requêtes et de réponses
- Des détails techniques pour les développeurs
Par exemple, vous pouvez :
- Obtenir une liste d’employés
- Récupérer les demandes de congé
- Vérifier les soldes de congé
- Accéder aux équipes, rôles et sites
Il existe également une option pour télécharger la spécification OpenAPI, utile si vous travaillez avec des développeurs ou des outils comme Postman. Considérez la documentation comme votre manuel d’instructions pour l’API.
4. Se connecter à l’aide de votre clé API
Pour connecter votre système à Day Off, vous devrez inclure votre clé API lors de l’envoi de requêtes.
- Ajoutez votre clé API comme suit :
x-api-key: VOTRE_CLÉ_API
Cette étape indique à Day Off que la requête provient de vous. Si la clé est manquante ou incorrecte :
- La requête ne fonctionnera pas
- Vous recevrez une erreur
5. Commencer à utiliser l’intégration
Une fois tout configuré, vous pouvez commencer à utiliser l’API. Vous pouvez maintenant :
- Obtenir des informations sur les employés
- Suivre ou gérer les demandes de congé
- Maintenir les données synchronisées avec vos autres outils
Cela vous aide à gagner du temps et à éviter de faire le même travail manuellement.
Best Practices (Highly Recommended)
Pour maintenir votre intégration sécurisée et fiable :
- Gardez votre clé API privée en tout temps
- Faites tourner vos clés API régulièrement (créez-en de nouvelles et supprimez les anciennes)
- Définissez toujours une date d’expiration pour une meilleure sécurité
- N’exposez jamais les clés API dans des applications frontend ou des dépôts publics
- Consultez toujours la documentation lors de la création de requêtes
L’API Day Off vous offre un contrôle et une flexibilité totaux pour connecter vos systèmes à Day Off. Bien que la configuration soit simple, elle ouvre la porte à une automatisation et une personnalisation puissantes.
Une fois tout en place, votre équipe peut réduire le travail manuel, éviter les erreurs et maintenir tous les systèmes parfaitement synchronisés.