Automatisch auf jeder Website veröffentlichen

Die Ereignisse des Webhooks

Suiko ruft Ihre Webhook-URL bei jeder Statusänderung eines Vorschlags auf. Bei den ersten drei enthält das JSON den vollständigen Inhalt.

• proposition.deposeeSuiko hat einen Vorschlag zur Prüfung eingereicht.
• proposition.approuveeEin Prüfer hat ihn freigegeben, er kann veröffentlicht werden.
• proposition.publieeDie Seite ist online (über einen Konnektor oder Ihren API-Aufruf).
• proposition.rejeteeDer Vorschlag wurde abgelehnt.
• proposition.correction_demandeeEin Prüfer bittet um eine Korrektur; eine neue Version folgt.
• proposition.conflitDie Seite hat sich in der Zwischenzeit auf der Website geändert; der Vorschlag wartet auf eine Entscheidung.
• proposition.echec_publicationDie Veröffentlichung über einen Konnektor ist fehlgeschlagen.

Das gesendete JSON

Dieselbe Struktur für alle Ereignisse. Der Block content ist nur bei den Ereignissen „eingereicht“, „freigegeben“ und „veröffentlicht“ enthalten. Der Header X-Suiko-Event enthält den Namen des Ereignisses.

{
  "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"
}

Die Signatur

Jeder Aufruf enthält den Header X-Suiko-Signature: „sha256=“, gefolgt vom HMAC-SHA-256 des unveränderten Request-Body, berechnet mit dem Geheimnis aus Einstellungen > API. Prüfen Sie die Signatur, wenn Ihre Webhook-URL öffentlich erreichbar ist. In Make und n8n wird darauf meist verzichtet. Bei einem Fehler wiederholt Suiko den Aufruf nach 5 und nach 20 Sekunden.

// 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'] ?? ''));

Die API

Basis-URL: https://app.getsuiko.com. Jeder Aufruf enthält den Header Authorization: Bearer chk_…. Die Antworten erfolgen im JSON-Format.

• GET/api/mises-a-jour?statut=approuveeDie Vorschläge Ihrer Organisation, gefiltert nach Status (mehrere Status kommagetrennt) und nach Datum (depuis=…).
• GET/api/mises-a-jour/{id}Ein Vorschlag mit seinem veröffentlichungsfertigen Inhalt, derselbe Block content wie im Webhook.
• POST/api/mises-a-jour/{id}/publieeMarkiert einen freigegebenen Vorschlag als veröffentlicht, optional mit der URL der veröffentlichten Seite im Body: { "url": "…" }.

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

Schlüssel und Geheimnis

Ein Administrator erstellt einen API-Schlüssel unter Einstellungen > API; er wird nur einmal angezeigt. Er gilt für die gesamte Organisation und lässt sich mit einem Klick widerrufen. Das Webhook-Geheimnis finden Sie an derselben Stelle.

Gut zu wissen

• Der Webhook setzt eine https-URL voraus. Ein fehlgeschlagener Aufruf wird bis zu zweimal wiederholt und dann protokolliert. Suiko wartet dabei nie auf die Antwort Ihres Servers.
• Das HTML im Block content ist dasselbe, das die Konnektoren veröffentlichen: Überschriften, Absätze, Listen, Tabellen, FAQ, ohne Layout-Formatierung.
• Eine freigegebene Seite wird bei der Freigabe auf Ihr Paket angerechnet, unabhängig davon, ob sie über einen Konnektor, über Ihr Tool oder durch Kopieren des Textes veröffentlicht wird.
• Wenn Sie für Webflow, Shopify, Drupal, Prismic oder ein eigenes CMS einen nativen Konnektor bevorzugen, entwickeln wir ihn auf Anfrage ohne Aufpreis.