Vous souhaitez récupérer des données présentes dans Eurécia pour alimenter un autre logiciel ? ou créer de nouveaux collaborateurs dans Eurécia ? C'est tout à fait possible avec l'API Eurécia !
Qui est concerné par cet article ?
L'administrateur en charge du paramétrage d'Eurécia.
Au programme dans cet article :
L'API, c'est quoi ?
Une API (Application Programming Interface) est une interface permettant à deux applications de communiquer entre elles. Elle rend disponibles des données ou des fonctionnalités d’une application existante afin que d’autres applications puissent les utiliser.
Oui d'accord ! mais concrètement ça sert à quoi ?
Applications
Le but est de pouvoir utiliser toutes ces données dans un autre logiciel. Par exemple, lorsqu'un utilisateur est créé dans Eurécia, l'utilisation de l'API peut éviter d'avoir à le recréer aussi dans un ERP ou un CRM ou tout autre outil. Des développeurs vont créer un programme qui va se connecter à notre API pour récupérer les informations souhaitées.
Les méthodes disponibles
L’API est disponible en lecture pour la majorité des données : récupérer des listes d'utilisateurs, des congés posés ou des temps déclarés par exemple et en écriture uniquement pour la création des collaborateurs et des axes/comptes analytiques.
Lecture des données (GET)
Deux formats sont à votre disposition pour l'API en lecture : json et xml.
Vous trouverez la liste de toutes les données disponibles sur les pages suivantes :
Ecriture , modification, suppression (PUT, POST, DELETE)
Notre API est disponible en écriture pour :
Génération du token
Accès : Espace admin > Paramètres généraux > Fiche société > onglet Paramétrage
|
|
Le Token, Access token, ou jeton d'authentification, est une chaîne de caractère permettant de contacter notre API en indiquant qui est l'utilisateur. Il est possible d'en générer plusieurs, pour différents profils utilisateurs par exemple ou pour un utilisateur spécifiquement.
Token utilisateur
Le token par utilisateur est plus fiable et plus flexible. Il permet de donner accès aux données via API à un (ou plusieurs) utilisateur spécifiquement.
Accès : Espace admin > Salariés & Utilisateurs > Fiche salarié > Onglet Administration
- j'ouvre la fiche salarié du collaborateur concerné
- je vais dans l'onglet Administration
- dans la rubrique API (web-services), je clique sur
pour générer un nouveau token - je clique sur 'Valider' et j'enregistre la fiche salarié
Token par profil utilisateur
Si vous préférez créer un token pour un profil utilisateur en général, vous pouvez créer un token pour un profil utilisateur en particulier.
Accès : Espace admin > Paramètres généraux > Fiche société > Onglet Paramétrage
- je vais dans l'onglet 'Paramétrage' de ma fiche société
- dans l'encart 'API', je clique sur pour générer un nouveau token
- j'indique quel est le profil utilisateur qui va se connecter à l'API avec ce token
- je clique sur 'valider la ligne'
- j'enregistre la page
|
|
Mots clés associés à cet article :
API - web services - génération - token - données - récupérer - transmettre - informations - fichier metadata - appel - api Eurécia - transmission - donnée - transfert -informations - flux - données - développeur - jeton - authentification - Application Programming Interface - connexion - API - chaîne - caractères - https://api.eurecia.com - URL API - requête - HTTP - Java - code - XML - JSON - Swagger
Commentaires
0 commentaire
Cet article n'accepte pas de commentaires.