Entrée de changelog publiée

Se déclenche lorsqu’une entrée de changelog est mise en ligne : lors de sa première publication ou d’une publication après sa mise hors ligne. La modification et la publication d’une entrée déjà en ligne ne le déclenchent pas à nouveau ; vous pouvez donc envoyer un e-mail à vos utilisateurs (vérifiez d’abord data.public). Dédupliquez sur data.id si vous ne voulez envoyer qu’un seul e-mail par entrée.

POST changelog_entry.published

Jeton Bearer

curl 'https://api.ferndesk.com/v1/changelog_entry.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": "changelog_entry.published",
  "created_at": "2026-07-09T18:25:43.511Z",
  "data": {
    "id": "art_01JXY9AZK4KV",
    "title": "Faster search",
    "slug": "faster-search",
    "url": "https://docs.example.com/faster-search-A1B2C3",
    "date": "2026-09-30",
    "tags": [
      "new"
    ],
    "announce": true,
    "public": true,
    "content_html": "<p>Search results now load twice as fast.</p>",
    "content_markdown": "Search results now load twice as fast.",
    "published_at": "2026-09-30T14:02:11.000Z",
    "published_by_member_id": "mem_01JXYB8W4Q2H",
    "source": "editor",
    "changelog": {
      "id": "col_01JXYA6ABN52",
      "title": "Changelog",
      "url": "https://docs.example.com/changelog-C0L123"
    }
  }
}'

Cette réponse n’a pas de corps.

Livraison reconnue ; toute autre réponse est réessayée avec un délai croissant.

En-têtes

· 3

webhook-id string requis

Enveloppe id, unique pour chaque événement.

webhook-timestamp string requis

Secondes Unix au moment où la requête a été signée ; rejetez les valeurs obsolètes.

webhook-signature string requis

Jetons v1, séparés par des espaces — plusieurs peuvent être présents lors de la rotation du secret — calculés comme décrit 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 transporté par cette livraison.

valeurs

changelog_entry.published

created_at string requis

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

data object requis

Entrée telle qu’elle a été mise en ligne, avec son contenu rendu en HTML et en Markdown afin que vous puissiez l’envoyer sans effectuer un autre appel API.

En-têtes

Corps

Réponses