Cet article explique ce qu’est une API publique, présente les fonctions des différentes API Données personnelles et décrit comment générer des identifiants pour ces API.

À quoi sert une API publique dans Personio ?

Les API permettent d’échanger des données entre Personio et un autre service ou outil. Vous pouvez alors établir des connexions entre Personio et vos propres bases de données ou configurer des intégrations avec des fournisseurs tiers disponibles sur Personio Marketplace.

Personio propose actuellement plusieurs API publiques : l’API Recrutement, l’API Rapports personnalisés et les quatre API Données personnelles (Employés, Absences, Présences et Documents).

Fonctions des différentes API Données personnelles

Les API Données personnelles permettent l’échange d’informations sur les données, les documents, les heures travaillées et les absences des employés. 

Chacune des API vous permet d’effectuer les opérations suivantes :

1. API pour les employés 
   ▶︎ Extraire de Personio les données concernant les employés.
   ▶︎ Créez des employés dans Personio
   ▶︎ Mettez à jour les données des employés dans Personio.
   
   

   Exemple
   Vous pouvez utiliser l’intégration avec MS Teams pour informer les employés utilisant un canal sélectionné des anniversaires et des anniversaires de service.

2. API pour les heures travaillées
   ▶︎ Extraire les données concernant les heures travaillées (y compris l’ID de projet) qui sont stockées dans Personio.
   ▶︎ Créez des heures travaillées dans Personio.
   ▶︎ Mettez à jour les heures travaillées dans Personio.
   ▶︎ Supprimez des heures travaillées dans Personio.
   
   

   Exemple
   Vous pouvez utiliser l’intégration avec askDante pour suivre les heures travaillées de vos employés. Les données suivies dans cette application sur les heures de début et de fin, ainsi que sur les pauses, peuvent ensuite être transférées dans Personio.

3. API pour les absences
   ▶︎ Extraire de Personio les données concernant les absences.
   ▶︎ Créez des absences dans Personio.
   ▶︎ Supprimez des absences dans Personio.
   
   

   Exemple
   Vous pouvez utiliser l’intégration avec Slack pour permettre à vos employés de faire des demandes d’absence directement dans Slack.

4. API pour les documents
   ▶︎ Extraire de Personio les données concernant les documents.▶︎ Envoyer un document vers le profil Personio d'un employé (seulement possible après avoir extrait les données des catégories de document).
   
   

   Exemple
   Vous pouvez utiliser l’intégration avec Pento pour recevoir des bulletins de salaire qui se trouvent dans Pento et les stocker dans le profil de l’employé.

Générer des identifiants API

1. 1. Accédez à Paramètres > Intégrations > Identifiants API.
   2. Cliquez sur Générer un nouvel identifiant.
   3. La barre latérale Ajouter un nouvel identifiant s’affiche. Dans le champ Nom, saisissez un nom évocateur (Identifiant Données sur le document, par exemple) pour l’identifiant API.
   4. Dans le menu déroulant Intégration, sélectionnez une intégration ou Autre.
   5. Cochez la case Lire, la case Écrire ou les deux pour l’API Données personnelles correspondante (Employés, Présences, Absences, Documents). Si vous cochez la case Lire pour l’API Employés, sélectionnez également les attributs personnalisés à transférer via l’API.

      Conseil
      Pour en savoir plus sur les différentes cases à cocher, consultez l’article Générer et gérer les identifiants API.

   6. Cliquez sur Générer un nouvel identifiant.
   7. Un message confirme que l’identifiant API a bien été créé.
2.  

Documentation technique

Toute la documentation sur nos différentes API Données personnelles, y compris les points de terminaison, les informations sur les données transférées et des tutoriels techniques, est disponible dans notre Developer Hub.

Pour POST et PATCH, seuls certains attributs système sont pris en charge. Les attributs pris en charge sont répertoriés dans notre Developer Hub, dans l'exemple Créer un employé. Les autres attributs système ne sont pas compatibles avec POST et PATCH.