Il existe différents moyens de mettre à jour sa base de données collaborateurs et parmi eux, notre API User management.
Cette API vous sera utile si vous avez des besoins spécifiques d’adaptation de vos données SIRH pour les intégrer à Supermood, ou simplement le désir d’automatiser la mise à jour en gardant le contrôle à 100%.
ℹ️ Documentation technique |
Dans cet article :
🔎 Qu’est-ce que l’API User management
Une API est un ensemble de protocoles qui sert à faire le lien entre deux logiciels pour un échange de données et de fonctionnalités. Vous pouvez voir ça comme un groupe de petits blocs qui vont permettre à votre équipe technique de construire un pont entre votre logiciel SIRH et Supermood.
Autrement dit, c'est ce qui va vous permettre de créer vous-même une intégration personnalisée, adaptée à vos besoins.
L’API User Management vous permet de mettre à jour automatiquement votre base de collaborateurs sur Supermood, en injectant des données venant de votre SIRH ou votre logiciel de paie, par exemple.
Vous pourrez ainsi rechercher, ajouter, modifier ou supprimer des collaborateurs sur Supermood.
💡 À noter
|
✨ Les possibilités d’intégration
Répondre à des besoins spécifiques
Cette API peut être intéressante si vous souhaitez automatiser le processus de mise à jour avec des besoins spécifiques à votre fonctionnement interne.
Par exemple, votre équipe technique peut s'employer à intégrer des règles de mise à jour avancées automatiques telles que 'si la date de début de contrat de l'employé est dans le futur, alors l'employé n'est pas ajouté à la plateforme'.
Intégrer plusieurs SIRH
Votre organisation s’étend sur plusieurs pays et vous devez gérer plusieurs SIRH ? Créer des intégrations API vous donnera l’opportunité d’uniformiser les données collaborateur pour faciliter leur intégration à Supermood.
💡 Si vous intégrez des données venant de plusieurs SIRH, assurez-vous bien que les identifiants personnels des collaborateurs ne comptent pas de doublons d’un SIRH à l’autre. |
Se réapproprier du temps
Une fois les automatisations mises en place, vous n’avez plus qu'un seul outil à mettre à jour : votre SIRH (ou assimilé). Ce sont les données de cet outil qui viendront nourrir votre base de données collaborateur Supermood.
Finies les mises à jour de masse mensuelles ou les ajustements manuels : les informations des employés sont à jour dès leur premier jour dans l'entreprise. Ça peut être très utile pour mettre en place un sondage d'onboarding !
💡 En fonction de votre SIRH et de vos mouvements internes, vous pouvez choisir d’appliquer des mises à jour en continu, quotidiennes, hebdomadaires ou mensuelles - adaptant ainsi les données de Supermood à votre rythme. |
✅ Les conditions requises
Pour pouvoir tirer parti de l’API User management, votre organisation doit avoir :
un logiciel SIRH ou assimilé (système de paie, etc.), contenant les informations hiérarchiques et démographiques de vos collaborateur à jour ;
⚠️ Pour les champs que vous mettez à jour via API, pensez bien à faire vos modifications dans votre SIRH et non plus dans la plateforme Supermood. Les modifications depuis la plateforme (manuelles ou par imports) seront écrasées par l’API. |
un(e) développeur(se) pour créer l’intégration à partir de la documentation.
🧰 Utiliser les APIs Supermood
1. Demander un compte test
En premier lieu, contactez votre Account Manager afin de bénéficier d’un environnement de test pour que vos équipes puissent développer votre intégration sereinement.
Pensez à inclure à cet échange la personne responsable de la mise en place de l’API (souvent votre DSI) afin que lui soit attribué un accès Administrateur sur le compte test.
2. Créer un compte de service
Une fois votre compte test disponible, vous (ou votre DSI, par exemple) devrez vous rendre dans Mon compte > Réglages > Intégrations. Ici, créez un compte de service en cliquant sur le bouton “Ajouter un compte de service”. Ce compte de service sera nécessaire à vos équipes de développement.
Attention, enregistrez bien l’identifiant et le mot de passe qui vous sont communiqués à cette étape - par mesure de sécurité, ils ne pourront pas vous être fournis à nouveau.
💡 Si vous intégrez les données de plusieurs SIRH, nous vous conseillons de créer un compte de service par SIRH. Cela vous assurera une sécurité plus élevée et la possibilité de retracer les actions de chaque API séparément si besoin. |
3. Développer
Transmettez les informations du compte de service, ainsi que la documentation ci-dessous à votre développeur(se) afin qu’il ou elle puisse créer l’intégration et l’éprouver sur le compte test.
ℹ️ Documentation technique
|
4. Déployer !
Une fois votre intégration testée et approuvée, créez un nouveau compte de service depuis votre compte principal (comme vu à l'étape 2.) et transmettez-le à votre développeur(se) afin qu’il ou elle puisse implémenter l'intégration. 🚀
Si vos équipes rencontrent un problème à l’utilisation de notre API, n’hésitez pas à lui indiquer de nous contacter à l’adresse [email protected] ! 💁♀️