Article publié

Déclenché lorsque le contenu en ligne d’un article change, y compris lors de sa première publication.

POST article.published

Jeton Bearer

curl 'https://api.ferndesk.com/v1/article.published' \
  --request POST \
  --header 'webhook-id: whevt_01JXYC5R2K9M' \
  --header 'webhook-timestamp: 1752096000' \
  --header 'webhook-signature: v1,K5oT8v...base64...' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "whevt_01JXYC5R2K9M",
  "type": "article.published",
  "created_at": "2026-07-09T18:25:43.511Z",
  "data": {
    "id": "art_01JXY9AZK4KV",
    "title": "Getting started with API keys",
    "slug": "getting-started-api-keys",
    "status": "published",
    "version": 3,
    "url": "https://docs.example.com/getting-started-api-keys-A1B2C3",
    "collection_id": "col_01JXYA6ABN52",
    "published_by_member_id": "mem_01JXYB8W4Q2H",
    "source": "api"
  }
}'

Cette réponse n’a pas de corps.

Livraison reconnue ; toute autre réponse est réessayée avec temporisation progressive.

En-têtes

· 3

webhook-id string requis

id de l’enveloppe, unique pour chaque événement.

webhook-timestamp string requis

Secondes Unix auxquelles la requête a été signée ; rejeter les valeurs obsolètes.

webhook-signature string requis

Jetons v1, séparés par des espaces — plusieurs lors de la rotation des secrets — calculés comme indiqué dans la section Vérification de la signature.

Corps

requis application/json

id string requis

Identifiant de l’événement, répété dans l’en-tête webhook-id.

type string · énumération requis

Type d’événement associé à cette livraison.

valeurs

article.published

created_at string requis

Date et heure de création de l’événement.

data object requis

Instantané de l’article au moment du déclenchement de l’événement.

En-têtes

Corps

Réponses