Publiez automatiquement sur n’importe quel site

Les événements du webhook

Suiko appelle votre adresse à chaque changement d’état d’une proposition. Sur les trois premiers, le JSON porte le contenu complet.

• proposition.deposeeLa machine a déposé une proposition, à relire.
• proposition.approuveeUn relecteur l’a approuvée : c’est le moment de publier.
• proposition.publieeLa page est en ligne (par un connecteur, ou par votre appel à l’API).
• proposition.rejeteeLa proposition a été rejetée.
• proposition.correction_demandeeUn relecteur demande une correction ; une nouvelle version suivra.
• proposition.conflitLa page a changé sur le site entre-temps ; la proposition attend une décision.
• proposition.echec_publicationUn connecteur n’a pas réussi à publier.

Le JSON envoyé

Même forme pour tous les événements ; le bloc content n’est présent que sur déposée, approuvée et publiée. L’en-tête X-Suiko-Event répète le nom de l’événement.

{
  "event": "proposition.approuvee",
  "proposal_id": "3f1c…",
  "version": 1,
  "status": "approuvee",
  "page_slug": "blog/japan-rail-pass",
  "page_url": "https://www.kankou.example/blog/japan-rail-pass",
  "page_title": "Japan Rail Pass : prix, fonctionnement et rentabilité",
  "content": {
    "title": "Japan Rail Pass : prix, fonctionnement et rentabilité",
    "html": "<h2>Prix du pass en 2026</h2><p>29 650 ¥ pour 7 jours…</p>",
    "meta_title": "Japan Rail Pass 2026 : prix et rentabilité | Kankou",
    "meta_description": "Prix, fonctionnement et rentabilité du Japan Rail Pass…",
    "faq": [{ "question": "Le pass est-il rentable pour 7 jours ?", "answer": "Dès un aller-retour Tokyo-Kyoto…" }]
  },
  "url": "https://app.getsuiko.com/updates/3f1c…",
  "at": "2026-10-31T09:12:00.000Z"
}

La signature

Chaque appel porte l’en-tête X-Suiko-Signature : « sha256= » suivi du HMAC SHA-256 du corps brut, calculé avec le secret affiché dans Paramètres > API. Vérifiez-le si votre adresse est publique ; Make et n8n s’en passent le plus souvent. En cas d’échec, Suiko réessaie après 5 secondes puis 20 secondes.

// Node.js : vérifier X-Suiko-Signature avec le secret de Paramètres > API
import { createHmac, timingSafeEqual } from 'node:crypto';
const expected = 'sha256=' + createHmac('sha256', process.env.SUIKO_WEBHOOK_SECRET).update(rawBody).digest('hex');
const ok = timingSafeEqual(Buffer.from(expected), Buffer.from(req.headers['x-suiko-signature'] ?? ''));

L’API

Base : https://app.getsuiko.com. Chaque appel porte l’en-tête Authorization: Bearer chk_…. Les réponses sont en JSON.

• GET/api/mises-a-jour?statut=approuveeLes propositions de votre organisation, filtrées par état (plusieurs états séparés par des virgules) et par date (depuis=…).
• GET/api/mises-a-jour/{id}Une proposition avec son contenu prêt à publier, le même bloc content que le webhook.
• POST/api/mises-a-jour/{id}/publieeMarque une proposition approuvée comme publiée, avec en option { "url": "…" } de la page en ligne.

curl -H "Authorization: Bearer chk_…" \
  https://app.getsuiko.com/api/mises-a-jour?statut=approuvee

Les clés

Une clé d’API se crée dans Paramètres > API par un administrateur ; elle s’affiche une seule fois. Elle vaut pour toute l’organisation et se révoque d’un clic. Le secret du webhook est au même endroit.

Bon à savoir

• Le webhook exige une adresse https. Un appel qui échoue est retenté deux fois, puis journalisé ; l’application, elle, n’attend jamais votre serveur.
• Le HTML du bloc content est celui que les connecteurs publient : titres, paragraphes, listes, tableaux, questions fréquentes, sans mise en page.
• Une page approuvée est décomptée de votre pack à l’approbation, qu’elle soit publiée par un connecteur, par votre outil ou en copiant le texte.
• Webflow, Shopify, Drupal, Prismic, un CMS maison : si vous préférez un connecteur natif, nous le développons sur demande, sans supplément.