Accéder à l'API Eurécia (Web Services) ^{Administrateur api webservice}

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 ?
  • Applications
• Les méthodes disponibles
  • Lecture des données

 

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 :

• Format xml
• Format Json

 

Ecriture , modification, suppression (PUT, POST, DELETE)

 Notre API est disponible en écriture pour :

• la création de nouveaux collaborateurs 
• création/modification/suppression de comptes analytiques

 

Génération du token

Accès : Espace admin > Paramètres généraux > Fiche société > onglet Paramétrage

 

A noter : Si l'encart API (web-services) n'est pas affiché, contactez le support Eurécia pour activer la fonctionnalité ! Nous serons ravis de pouvoir vous apporter toutes les informations nécessaires 😊 !

 

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

 

 

A noter : Il est obligatoire de rattacher un utilisateur existant au profil utilisateur sélectionné.

 

 

 

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