Développeurs
Le module Développeurs vous permet de connecter Unisoft à vos outils externes : automatisations no-code (Make, n8n, Zapier), scripts internes, CRM externes, etc. Il regroupe deux mécanismes d'intégration : les clés API et les webhooks sortants.
Deux briques complémentaires
Les intégrations Unisoft reposent sur deux mécanismes différents, qui répondent à deux besoins distincts. Vous pouvez les utiliser indépendamment ou en combinaison.
Clés API — pour aller chercher des données
Une clé API permet à un outil externe d'interroger Unisoft à la demande pour récupérer des informations : la liste des contacts, les paiements de la semaine, les soumissions d'un formulaire, etc.
Exemples de cas d'usage :
- Un scénario Make qui synchronise chaque heure les nouveaux contacts vers Mailchimp.
- Un script Python qui exporte chaque nuit les paiements vers un outil de comptabilité.
- Un tableau de bord externe (Looker, Metabase) qui interroge l'API pour afficher des KPI.
En clair : c'est vous (ou votre outil) qui demandez à Unisoft les données quand vous en avez besoin.
Webhooks sortants — pour être notifié en temps réel
Un webhook sortant est l'inverse : c'est Unisoft qui appelle votre outil dès qu'un événement métier se produit (un nouveau paiement, un formulaire soumis, un contact créé…).
Exemples de cas d'usage :
- Envoyer automatiquement un email de remerciement personnalisé à chaque nouveau donateur (via Make).
- Créer une carte Trello dès qu'un formulaire « demande de rendez-vous » est soumis.
- Notifier un canal Slack à chaque don supérieur à 500 €.
- Synchroniser les nouveaux contacts dans votre CRM principal (HubSpot, Salesforce) en temps réel.
En clair : c'est Unisoft qui vous notifie dès qu'il se passe quelque chose, sans attendre que vous demandiez.
Documentation interactive de l'API
En haut à droite de la page Développeurs, un bouton « Documentation API » ouvre la documentation Swagger interactive d'Unisoft. Vous y trouvez :
- la liste complète des endpoints disponibles ;
- le format des requêtes (paramètres, body, headers) ;
- le format des réponses (avec exemples JSON) ;
- la possibilité d'essayer les appels directement depuis le navigateur (après authentification avec votre clé API).
C'est la ressource de référence pour vos développeurs ou pour configurer un appel HTTP dans Make / n8n / Zapier.
Les deux onglets
La page /app/developpeurs/tabs est organisée en deux onglets :
Bonnes pratiques de sécurité
Les intégrations donnent à des outils externes un accès à vos données Unisoft. Quelques règles d'or :
| Règle | Pourquoi |
|---|---|
| Une clé par usage | Si une clé est compromise, vous la révoquez sans casser les autres intégrations |
| Le minimum de permissions | Limitez chaque clé aux permissions strictement nécessaires (ex. seulement paiements:read) |
| Stocker les secrets dans un coffre-fort | Jamais en clair dans un fichier non protégé ; utilisez un gestionnaire de mots de passe ou les variables d'environnement de votre outil |
| Révoquer en cas de doute | Une clé révoquée stoppe immédiatement l'intégration ; il vaut mieux la recréer après que de laisser un risque actif |
| Surveiller la dernière utilisation | Une clé jamais utilisée depuis plusieurs mois est suspecte ; révoquez-la |
À retenir
- La page Développeurs est accessible par URL directe :
/app/developpeurs/tabs. - Deux mécanismes : les clés API (vous interrogez Unisoft) et les webhooks sortants (Unisoft vous notifie).
- Le bouton Documentation API ouvre le Swagger interactif pour explorer les endpoints.
- Côté sécurité, une clé par usage et le minimum de permissions sont les deux règles essentielles.
Aller plus loin
- Clés API — créer et gérer vos clés
- Webhooks sortants — recevoir des notifications en temps réel