Aller au contenu
Quiet Social

Clés API et webhooks

Une clé API permet à une application — votre site, votre boutique — de publier par l'API au nom de l'espace de travail ; un webhook prévient cette application, par un appel signé, quand une publication change d'état.

Les menus Clés API et Webhooks sont réservés aux administrateurs et au propriétaire de l'espace. Le fonctionnement de l'API elle-même est décrit dans la référence de l'API.

Créer une clé API

Menu Clés API, puis Créer une clé API :

Champ Note
Nom Obligatoire, 100 caractères au plus. Il sert à reconnaître l'application qui se sert de la clé : « Site vitrine », « Boutique ».
Marque Facultative. Vide, la clé couvre « Tout l'espace de travail ». Une clé bornée à une marque ne voit ni ne publie rien des autres.
Droits Au moins un. Chaque droit ouvre une partie de l'API : voir Périmètres.

Créer la clé ouvre la fenêtre Votre nouvelle clé API, qui affiche l'Identifiant (qsc_…) et le Secret (qss_…), chacun avec un bouton de copie.

Le secret n'est affiché qu'une seule fois. Copiez-le avant de fermer la fenêtre avec J'ai copié le secret : il ne pourra plus être relu, seulement remplacé par une nouvelle clé.

Une clé sert aussi à brancher un assistant conversationnel sur Quiet Social, par le serveur MCP : il lira vos publications et préparera des brouillons avec les droits de la clé. Créez-lui une clé à part, avec les seuls droits utiles et, si possible, bornée à une marque.

Suivre et révoquer une clé

La liste montre, pour chaque clé, son Nom, son Identifiant, sa Marque, ses Droits, sa Dernière utilisation et son État : Active ou Révoquée. Le filtre Actives seulement est appliqué par défaut.

Une clé ne se modifie pas. Pour changer ses droits ou sa marque, créez-en une nouvelle, faites basculer l'application, puis révoquez l'ancienne.

Révoquer coupe l'accès de l'application dès sa requête suivante. Une clé révoquée ne se réactive pas.

La création et la révocation d'une clé sont consignées à l'historique, comme la déclaration, la modification, la réactivation et la suppression d'un webhook.

Déclarer un webhook

Menu Webhooks, puis Déclarer un webhook :

Champ Note
Adresse Obligatoire. En https, sur une adresse publique : une adresse locale, privée ou réservée est refusée dès la saisie.
Événements Au moins un, pris dans le catalogue.
Marque Facultative. Vide, l'endpoint reçoit les événements de « Tout l'espace de travail ». Bornée, il ne reçoit que ceux de la marque.

Déclarer ouvre la fenêtre Secret de signature. Votre application s'en sert pour vérifier la signature de chaque appel. Il n'est affiché qu'une seule fois : copiez-le avant de fermer avec J'ai copié le secret.

Les webhooks déclarés par l'API apparaissent dans cette liste, et ceux déclarés ici sont visibles par l'API : c'est le même endpoint.

Gérer un webhook

La liste montre l'Adresse, la Marque, les Événements, l'État — Actif ou Suspendu —, le nombre d'Échecs consécutifs et le Dernier succès. Le menu de chaque ligne propose :

  • Envoyer un test : une notification de contrôle, webhook.test, part par le même chemin qu'une vraie. Son sort apparaît dans les livraisons de l'endpoint. Un endpoint Suspendu ne reçoit pas de test : réactivez-le d'abord. Cinq tests par minute et par endpoint au plus, tableau de bord et API confondus.
  • Réactiver, pour un endpoint Suspendu après des échecs répétés ou une adresse refusée : vérifiez d'abord qu'il répond de nouveau. L'adresse est vérifiée une nouvelle fois, et une adresse toujours interdite empêche la réactivation. Le compteur d'échecs repart de zéro, et la suspension reviendra si rien n'a changé.
  • Modifier l'adresse ou les événements. La marque ne se change pas.
  • Supprimer : l'adresse ne reçoit plus rien, et l'historique de ses livraisons part avec elle.

Les livraisons

La page d'un webhook reprend son état — dont la date du Dernier échec — et liste ses Livraisons, les plus récentes d'abord : l'Événement, le Statut, le nombre de Tentatives, la Réponse (le code HTTP renvoyé par votre application) et la Date.

Statut Sens
En attente La livraison attend sa première tentative ou une reprise.
Livrée Votre application a répondu par un code 2xx.
Échouée Toutes les tentatives ont échoué.
Adresse refusée L'adresse menait, au moment de l'envoi, vers une destination interdite ; l'endpoint est suspendu.

Les livraisons sont conservées 30 jours. Les reprises et la suspension sont détaillées dans la référence des webhooks.