Centre d'aide

API et Webhooks

Peerdom fournit une API REST et un système de webhooks pour créer des intégrations personnalisées. Utilisez l’API pour lire et écrire des données organisationnelles. Utilisez les webhooks pour recevoir des notifications en temps réel lorsque votre Carte change.

API REST

La documentation complète de l’API est disponible sur api.peerdom.org/v1/docs.

Authentification

Chaque requête API nécessite une clé API dans les en-têtes de la requête. Chaque clé fonctionne dans le contexte d’une seule organisation.

Pour créer une clé API, rendez-vous dans Paramètres > Mes données > Clés API dans les Paramètres de l’organisation et cliquez sur Créer une clé. Seuls les utilisateurs disposant des droits d’accès propriétaire peuvent créer et gérer les clés API.

Les clés API accordent un accès complet en lecture et écriture aux données de votre organisation. Traitez-les comme des mots de passe et ne les partagez jamais dans des dépôts publics ou du code côté client.

Cas d’utilisation

L’API prend en charge un large éventail d’intégrations :

  • Synchroniser les données organisationnelles avec votre SIRH ou plateforme RH
  • Exporter les Roles, Circles et données des collègues pour le reporting
  • Créer des tableaux de bord personnalisés ou des outils internes
  • Alimenter d’autres systèmes avec la structure organisationnelle

Webhooks

Les webhooks envoient des requêtes HTTP POST à votre endpoint chaque fois que des événements spécifiques se produisent dans Peerdom. Configurez les webhooks dans Paramètres > Mes données > Webhooks dans les Paramètres de l’organisation.

Événements disponibles

  • Role : Création, Mise à jour, Suppression
  • Groupe : Création, Mise à jour, Suppression
  • Collègue : Création, Mise à jour, Suppression

Tester votre endpoint

Utilisez la fonctionnalité Tester l’URL dans le panneau de configuration des webhooks pour valider votre endpoint avant de l’enregistrer. Cela envoie un payload d’exemple afin que vous puissiez confirmer que votre serveur traite correctement la requête.

Configurez des webhooks pour déclencher des Zaps Zapier ou des flux de travail n8n en temps réel, plutôt que d'interroger l'API selon un calendrier.

Plateformes d’automatisation

Plusieurs plateformes no-code et low-code fonctionnent bien avec l’API Peerdom :

  • Zapier : Connectez Peerdom à plus de 7 000 applications avec un constructeur de flux de travail visuel. Consultez le guide d’intégration Zapier.
  • Pipedream : Plateforme orientée développeurs avec des déclencheurs HTTP, des étapes de code personnalisé (JavaScript et Python) et un niveau gratuit généreux.
  • n8n : Automatisation de flux de travail open-source et auto-hébergeable avec des noeuds HTTP Request et plus de 400 intégrations intégrées.

Les trois plateformes peuvent consommer les webhooks Peerdom et appeler l’API REST pour créer des flux de travail bidirectionnels.

En lien