Supervision des intégrations
Cet écran répond à deux questions : vos intégrations, synchronisations et webhooks fonctionnent-ils toujours, et combien vos systèmes utilisent l’API par rapport au quota de votre offre.
1. Les quatre chiffres d’usage de l’API
« Limite de débit (req/min) » est le nombre maximal d’appels par minute que permet votre offre. « Requêtes (24 h) » et « Requêtes (7 j) » comptent les appels faits avec vos clés API sur le dernier jour et la dernière semaine. « Limitées (24 h) » sont celles rejetées le dernier jour pour dépassement de la limite : si ce n’est pas 0, un système appelle trop vite et perd des données.
2. Quelle clé consomme
« Utilisation par clé API (7 j) » liste chaque clé avec ses requêtes de la semaine et, parmi elles, combien ont été limitées. « Trafic de session (JWT) » correspond aux requêtes des personnes qui utilisent l’application, pas d’un système. S’il y a des requêtes limitées, cherchez ici la clé qui a le plus de trafic, demandez à la personne qui maintient ce système d’espacer ou de regrouper les appels, et si le volume est légitime, passez à une offre supérieure (visible dans “Mon abonnement”).
3. Synchronisations et alertes
« Synchronisations et échange de fichiers » affiche chaque tâche avec son état, une barre de ses dernières exécutions, la dernière exécution réussie, le dernier échec avec son motif et le nombre d’exécutions échouées d’affilée. “Aucun succès depuis N h” signifie que le délai fixé est passé sans exécution réussie.
S’il y a des alertes, le bloc “Alertes” apparaît : “Échecs répétés” ou “Aucune exécution réussie dans le délai attendu”, “Ouverte” ou “Résolue”, et si l’e-mail a été envoyé, a échoué ou n’a pas de destinataire. Une alerte se résout d’elle-même quand une exécution réussit de nouveau.
4. Webhooks sortants
« Webhooks sortants » résume « Abonnements », « Envois (7 j) », « En échec (7 j) » et « Messages non remis », c’est-à-dire les envois échoués après tous les essais. Si des abonnements ont été désactivés après des échecs répétés, un avis l’indique. “Les renvoyer depuis l’écran des webhooks” mène à Webhooks, où les envois échoués sont renvoyés.
5. Réparer une intégration en erreur
« Intégrations » liste les intégrations configurées avec leur état (“Active”, “Erreur”, “Expirée”, “Désactivée”, “En test” ou “Non configurée”), la date de leur dernière vérification et, le cas échéant, leur dernière synchronisation. Pour une entreprise sans intégration, le message « Aucune intégration configurée pour l'instant. » s’affiche.
Pour réparer une intégration en “Erreur” : 1. Allez dans “Intégrations” et cliquez sur “Configurer” pour elle. 2. Vérifiez les identifiants : la cause habituelle est un jeton expiré ou révoqué dans l’autre service. 3. Cliquez sur “Enregistrer la configuration” puis sur “Tester la connexion”. 4. Revenez ici : elle doit apparaître “Active” avec la vérification du jour.