Cet article explique ce qu’est une API publique, présente les fonctions de l’API Rapports personnalisés et décrit comment générer des identifiants pour cette 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 de l’API Rapports personnalisés

L’API Rapports personnalisés vous permet de créer des analyses et des rapports plus avancés. 

Selon le point de terminaison, cette API vous permet de :

• • • • • récupérer la liste de tous les rapports personnalisés existants dans votre compte Personio (point de terminaison GetReports) ;
        • récupérer la liste de toutes les colonnes du tableau des rapports (point de terminaison GetColumns) ;
        • récupérer les données d’un rapport personnalisé donné au format JSON (point de terminaison GetReportData).

Avec l’API Rapports personnalisés, vous pourrez fusionner les données RH de Personio avec d’autres ensembles de données, les stocker dans un entrepôt de données et les traiter davantage dans un outil BI (Business Intelligence).

Exemple
Vous pouvez utiliser l’API Rapports personnalisés pour récupérer l’historique des données des employés ainsi que le nombre d’heures supplémentaires effectuées par les employés au cours d’un mois spécifique.

Remarque
L’API Rapports personnalisés ne permet pas à l’heure actuelle de créer ou de modifier un rapport personnalisé.

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 Rapports personnalisés, 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 pour l’API Rapports personnalisés.
      

      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éé.

   

   Conseil
   Vous pouvez également activer le point de terminaison Lire Rapports personnalisés pour un identifiant API existant. Accédez à Paramètres > Intégrations > Identifiants API, cliquez sur un identifiant et cochez la case Rapports personnalisés.
   

   Remarque
   Tous les rapports existants peuvent être récupérés si le point de terminaison Lire est activé. En outre, la section Attributs de l’employé lisibles pour l’API Données personnelles ne sera pas prise en compte pour le point de terminaison Rapports personnalisés. Tous les attributs ajoutés à un rapport personnalisé peuvent être récupérés via le point de terminaison s’il est activé pour les identifiants respectifs, que l’attribut ait été mis sur liste blanche ou non. 

    

   Documentation technique

   Toute la documentation sur notre API Rapports personnalisés, 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.