Connecter d'autres systèmes avec l'API ouverte RH

L'API ouverte RH permet à un autre système de lire vos personnes, la présence, les congés et la paie définitive, et d'envoyer des pointages, avec une clé que vous créez. Les webhooks RH préviennent ce système quand quelque chose se produit.

Avant de commencer

• Vous devez être le dirigeant. Les responsables ne peuvent pas créer de clés, même avec tous les droits RH.
• Les RH sont activées.

Créer une clé

1. Ouvrez RH → Paramètres RH et, dans Libre-service et équipe, sélectionnez API ouverte RH.
2. Cochez L'API ouverte est activée et sélectionnez Enregistrer. La page affiche l'Adresse de base.
3. Sous Créer une clé, saisissez l'Usage (par exemple "cabinet de paie").
4. Sous Peut, cochez uniquement ce dont le système a besoin : lire les personnes, lire la présence, envoyer des pointages, lire les congés, lire la paie définitive, gérer les webhooks.
5. Sélectionnez Créer la clé.
6. Copiez la clé tout de suite et transmettez-la à l'autre système. Elle n'est affichée qu'une fois ; Kluvan n'en conserve qu'une empreinte (hash).

Ajouter un webhook

1. Sous Ajouter un webhook, saisissez l'URL de votre système (elle doit commencer par https).
2. Cochez les événements : employee.created, employee.left, punch.recorded, leave.approved et payroll.paid. Tous sont cochés au départ.
3. Sélectionnez L'ajouter et copiez le secret de signature, qui n'est affiché qu'une fois.
4. Consultez Envois pour voir ce qui a été envoyé, son statut et le nombre de tentatives.

Bon à savoir

• Clés séparées. Les clés RH forment un système à part, distinct de toute autre clé d'API Kluvan, et elles n'accèdent qu'aux données RH de votre organisation.
• Une clé ne lit jamais les coordonnées bancaires, les documents ni les données biométriques. lire la paie définitive ne renvoie que les paies payées, jamais les brouillons, et aucun IBAN ni numéro de compte.
• Sélectionnez Révoquer pour arrêter une clé immédiatement. La liste indique quand chaque clé a été utilisée pour la dernière fois et combien d'appels elle a effectués.
• Une clé peut faire 10 appels par seconde, avec de courtes pointes jusqu'à 60. Une période demandée peut aller jusqu'à 92 jours.
• Un pointage envoyé par l'API est ajouté comme correction, avec le nom de la clé comme auteur. Envoyez chaque pointage une seule fois : le même pointage envoyé deux fois apparaît deux fois sur la feuille de temps, et un responsable doit en retirer un.
• Les webhooks sont signés avec le secret (HMAC-SHA256 dans l'en-tête X-Hr-Signature). Un envoi échoué est retenté pendant environ une journée ; un webhook qui échoue 20 fois de suite est désactivé jusqu'à ce que vous le réactiviez.
• Pas encore essayé avec un point de terminaison réel : l'envoi des webhooks n'a été testé que dans notre propre environnement de test. Testez avec votre système avant de vous y fier.
• La création et la révocation des clés, ainsi que chaque pointage envoyé, sont inscrites au journal d'activité.
• Pour les développeurs, la documentation technique est accessible depuis la page : Découvrez comment l'appeler.