API et Webhooks
Onglets
La page API et Webhooks est l’endroit où votre équipe gère les outils pour connecter PlatoForms à des services externes : des points de terminaison de webhook qui envoient les soumissions de formulaires à d’autres systèmes, des applications OAuth2 pour les intégrations tierces, et des jetons à longue durée de vie pour les appels API de serveur à serveur. Ce chapitre explique comment accéder à la page et configurer chacun de ces éléments.
Accéder à la page API et Webhooks
-
Connectez-vous à votre tableau de bord.
-
Dans la barre latérale gauche, cliquez sur le nom de votre équipe pour ouvrir le menu de l’équipe.
-
Sélectionnez API et Webhooks dans la liste.
Ce que vous verrez en fonction de vos autorisations
Si vous avez accès
La page s’ouvre directement sur URL API & Jetons, où vous pouvez voir et gérer vos webhooks, applications OAuth2 et jetons.
Les administrateurs d’équipe ont toujours un accès direct à cette page.
Si vous n’avez pas accès
API et Webhooks est affiché avec une icône de verrou et une étiquette “Demander l’accès à l’administrateur”.
Cliquez sur Demander l’accès à l’administrateur pour envoyer une demande.
L’administrateur de votre équipe reçoit un e-mail l’informant de la demande. Une fois l’accès accordé, vous pourrez ouvrir API et Webhooks depuis votre propre menu d’équipe.
Configurer les points de terminaison Webhook
Configurez des points de terminaison pour recevoir des notifications en temps réel lorsque des formulaires sont soumis ou que d’autres événements se produisent. Utile pour intégrer les données des formulaires dans d’autres applications ou services.
Cliquez sur + Ajouter un point de terminaison pour en créer un nouveau, ou sur l’icône de modification à côté d’un point de terminaison existant pour le modifier.
Lors de l’ajout ou de la modification d’un point de terminaison, vous pouvez configurer :
| Champ | Description |
|---|---|
| Nom | Un label pour vous aider à identifier le point de terminaison. |
| URL WebHook | L’URL qui recevra la requête POST. |
| Formulaire cible | Choisissez Tous les formulaires pour déclencher le webhook pour toute soumission de formulaire, ou sélectionnez un formulaire spécifique. |
| Inclure des liens partageables | Inclure des liens de soumission partageables dans la charge utile. |
| Données de soumission en Dict (au lieu de Liste) | Modifier la structure des données de soumission dans la charge utile. |
| Hook instantané (Pas d’attente pour la création du PDF) | Déclencher le webhook immédiatement au lieu d’attendre que le PDF de soumission soit généré. |
| Exclure les données de signature de la charge utile | Omettre les données de signature de la charge utile. |
| Webhook activé | Activer ou désactiver le point de terminaison sans le supprimer (disponible lors de la modification d’un point de terminaison existant). |
Cliquez sur Enregistrer pour appliquer vos modifications, ou sur Supprimer pour supprimer complètement le point de terminaison.
Créer une application OAuth2
Les API de PlatoForms sont protégées par le protocole OAuth2, un cadre d’authentification et d’autorisation sécurisé. Une “Application OAuth2” fait référence à une application enregistrée utilisant OAuth 2.0 pour interagir avec le système.
En créant une application OAuth2, vous pouvez obtenir en toute sécurité un ID Client et un Secret Client via un processus d’authentification. Cela facilite à son tour l’autorisation sécurisée d’autres applications à accéder à l’API de la plateforme. La création d’une ‘Application OAuth2’ configure les composants essentiels pour une intégration sécurisée, permettant des interactions avec l’API utilisant OAuth2 pour l’authentification et l’autorisation.
Pour créer une application OAuth2 :
-
Cliquez sur + Ajouter une application.
-
Dans la fenêtre qui s’ouvre :
-
Fournissez un Nom pour votre application, ce qui aide à l’identifier dans le système.
-
Spécifiez une URL de redirection, qui est cruciale pour le flux OAuth2.
-
-
Confirmez vos paramètres en cliquant sur Enregistrer.
Une fois l’application enregistrée, le système génère un ID Client et un Secret Client uniques.
Créer et réinitialiser votre jeton
Si vous êtes un développeur nécessitant un accès prolongé à l’API, la plateforme offre la possibilité de créer et de réinitialiser le Jeton sans expiration de votre équipe. Cette fonctionnalité élimine le besoin de rafraîchir régulièrement le jeton, assurant un accès API ininterrompu et prolongé pour les requêtes de serveur à serveur. Chaque équipe dispose d’un seul jeton sans expiration.
Cliquez simplement sur Créer ou réinitialiser pour générer le jeton, et utilisez Supprimer pour le retirer si nécessaire. Cette fonctionnalité simplifie le processus de gestion de l’accès à long terme à l’API.
Traitez les jetons, les IDs Clients et les Secrets Clients comme des mots de passe. Toute personne y ayant accès peut accéder aux données de votre équipe.
Si vous préférez travailler avec vos formulaires de manière conversationnelle via un assistant IA — sans écrire de code — consultez Assistant IA (MCP).