Cet article explique comment générer et gérer les identifiants pour les API publiques de Personio.
En savoir plus sur les identifiants API
Les API permettent à Personio de partager des données avec d’autres services ou outils. Les identifiants API agissent comme une clé. Ils contrôlent le flux d’informations et décident de ce qui sera partagé. Ces identifiants établir des connexions et protéger les communications entre les applications.
Gérer les identifiants API dans Personio
Dans Personio, le système crée les identifiants API pour les éléments suivants :
-
- API Recrutement
- Intégrations à partir de Personio
- Intégrations de partenaires Personio
Vous ne pouvez pas gérer vous-même ces identifiants. Vous pouvez mettre à jour ces intégrations dans Personio Marketplace. Le système définit la plupart des droits d’accès API sur le niveau nécessaire pour que l’intégration fonctionne. Vous générez et gérez généralement manuellement les identifiants API pour les intégrations personnalisées. Les employés peuvent uniquement utiliser la Marketplace et configurer des intégrations s'ils disposent de droits de modification pour Intégration Marketplace et API.
Générer les identifiants API pour les intégrations personnalisées
Personio crée automatiquement des identifiants API pour toutes les intégrations, sauf celles qui sont personnalisées. Pour générer les identifiants pour les intégrations personnalisées :
- Accédezà Marketplace > Intégrations connectées.
- Cliquez sur Créer une intégration personnalisée en haut à droite de l'écran.
- Effectuez la configuration.
| Droits d’accès à l’intégration | Droits de lecture | Droits d’écriture |
| employés |
Autorisez les systèmes tiers à extraire les données qui sont stockées dans Personio. |
Autorisez les systèmes tiers à créer et à mettre à jour des données dans Personio. |
| Heures travaillées |
Autorisez les systèmes tiers à extraire les données qui sont stockées dans Personio. |
Autorisez les systèmes tiers à créer, mettre à jour et supprimer des données dans Personio. |
| Absences |
Autorisez les systèmes tiers à extraire les données qui sont stockées dans Personio. |
Autorisez les systèmes tiers à créer et à mettre à jour des données dans Personio. |
| Documents |
Autorisez les systèmes tiers à extraire les identifiants des catégories de documents qui sont stockés dans Personio. |
Autoriser les systèmes tiers à créer des documents dans Personio. |
| Rapports personnalisés |
Autorisez les systèmes tiers à récupérer tous les rapports personnalisés qui sont stockés dans Personio. Cochez cette case pour que tous les attributs d’un report personnalisé puissent être récupérés. Cela s’applique même s’ils n’apparaissent pas sous les attributs de l’employé lisibles. |
Non applicable. |
| Webhooks |
Récupérer les métadonnées de webhook. |
Créer, mettre à jour et supprimer les webhooks. Les autorisations Lire et Écrire n’affectent pas le déclenchement d’un webhook. Un webhook continue de fonctionner après que vous l’avez créé, quels que soient les paramètres d’autorisation. Pour en savoir plus sur les webhooks, consultez notre documentation technique. |
Gérer les identifiants API pour les intégrations personnalisées
Pour mettre à jour les droits d’accès des intégrations personnalisées :
- Accédez à Marketplace > Intégrations connectées.
- Cliquez sur l'intégration à mettre à jour.
- Dans la fenêtre qui s'affiche, apportez les modifications.
- Cliquez sur Enregistrer pour sauvegarder les paramètres.
Vous pouvez également réinitialiser les identifiants API en suivant les instructions.
Déconnecter ou désactiver des identifiants API
- Accédez à Marketplace > Intégrations connectées.
- Dans la colonne Action,cliquez sur les trois points.
- Cliquez sur Désactiver pour désactiver temporairement un identifiant.
- Cliquez sur Déconnecter pour supprimer définitivement les identifiants.
Accéder à la documentation technique
Vous trouverez toute la documentation sur les API dans notre Developer Hub. Cela inclut les points de terminaison, les webhooks, les informations sur les données et les tutoriels. Le Developer Hub existe deux versions avec un contenu différent. Les informations sur le webhook sont de la version 2.0. Pour changer de version, cliquez sur le numéro de version en haut de la page d'accueil.