Lister les entrées du changelog

Récupère les entrées de changelog publiées, de la plus récente à la plus ancienne, avec filtre optionnel par tag.

Réponse exemple

{
  "data": [
    {
      "id": "f3b9c2a1-4e8d-4c7a-9b21-6f0a8c2d1e34",
      "tag": "security",
      "slug": "data-room-sealed-inbox",
      "title": "Inbox scellée pour la Data Room M&A",
      "excerpt": "Les dépôts externes sont désormais chiffrés de bout en bout via sealed-box X25519.",
      "published_at": "2026-05-28T09:15:00.000Z",
      "release_date": "2026-05-28",
      "version_label": "v8.3"
    },
    {
      "id": "a17c5e90-2db4-41f8-8c3a-1e7b9d0f4c22",
      "tag": "api",
      "slug": "api-rate-limit-headers",
      "title": "En-têtes de rate-limit normalisés",
      "excerpt": "Toutes les réponses API exposent désormais X-RateLimit-Policy.",
      "published_at": "2026-05-14T08:00:00.000Z",
      "release_date": "2026-05-14",
      "version_label": "v8.2"
    }
  ],
  "filter": {
    "tag": null,
    "limit": 20
  },
  "object": "list"
}

GET/v1/changelogListe les entrées de changelog publiées, triées par date de sortie décroissante.

Cet endpoint renvoie les entrées du changelog public de Coffrify qui ont le statut published. Les résultats sont triés par date de sortie décroissante (les plus récentes d'abord). Seules les entrées publiées sont exposées : les brouillons et les entrées planifiées restent invisibles via l'API. Cet endpoint n'utilise pas l'idempotence (la lecture est sans effet de bord) et chaque entrée est volontairement légère (résumé, pas le corps complet).

Authentification

Cet endpoint requiert une clé API valide, aucun scope spécifique n'est exigé. Le handler est déclaré sans requiredScope, donc toute clé cof_live_*, cof_test_*, restreinte (cof_rk_*) ou jeton MCP (cof_mcp_*) active suffit, dès lors qu'elle passe les contrôles de cycle de vie (non révoquée, non expirée, IP autorisée). Transmettez-la dans l'en-tête Authorization: Bearer cof_live_....

Paramètres de requête

Paramètre	Type	Requis	Description
limit	integer	Non	Nombre maximum d'entrées renvoyées. Borné entre 1 et 100, valeur par défaut 20. Toute valeur non numérique ou hors borne est ramenée dans l'intervalle (clamp).
tag	string	Non	Filtre les entrées sur un tag exact (par exemple `security`, `api`). Si absent, toutes les entrées publiées sont incluses.

Réponse

La réponse est un objet liste : object vaut toujours "list", data contient le tableau d'entrées et filter rappelle les paramètres appliqués (tag et limit). Chaque entrée expose : id (identifiant), slug, version_label (libellé de version), title, excerpt (résumé), release_date (date de sortie), tag et published_at (horodatage de publication). Si aucune entrée ne correspond, data est un tableau vide ([]).

Champ	Type	Description
object	string	Toujours `"list"`.
data	array	Tableau des entrées de changelog publiées.
data[].id	string	Identifiant unique de l'entrée.
data[].slug	string	Slug lisible de l'entrée.
data[].version_label	string	Libellé de version associé (ex. `v8.3`).
data[].title	string	Titre de l'entrée.
data[].excerpt	string	Résumé court de l'entrée.
data[].release_date	string	Date de sortie (ordre de tri).
data[].tag	string	Tag de catégorisation, ou `null`.
data[].published_at	string	Horodatage ISO 8601 de publication.
filter	object	Rappel des filtres appliqués : `{ tag, limit }`.

Erreurs

Code	Quand	Résolution
401 missing_api_key	Aucun en-tête `Authorization` fourni et pas de session valide.	Ajoutez l'en-tête `Authorization: Bearer cof_live_...`.
401 invalid_api_key	Préfixe de clé non reconnu, clé introuvable ou inactive.	Vérifiez la clé ou régénérez-en une depuis app.coffrify.com/developer.
401 revoked_api_key	La clé a été révoquée.	Émettez une nouvelle clé API.
401 expired_api_key	La clé a dépassé sa date d'expiration.	Émettez une nouvelle clé API.
403 ip_not_allowed	L'IP appelante n'est pas dans l'allowlist de la clé.	Appelez depuis une IP autorisée ou ajustez l'allowlist.
429 rate_limited	Quota de requêtes par minute dépassé pour le workspace, ou nombre maximal d'utilisations de la clé atteint.	Respectez l'en-tête `Retry-After` puis réessayez.
500 internal_error	Erreur serveur (ex. RPC de validation indisponible).	Réessayez ; consultez le `request_id` renvoyé si le problème persiste.

Voir aussi

GET /v1/welcome : point d'entrée public de découverte de l'API.
GET /v1/blog : contenu CMS publié exposé selon le même modèle de liste.
GET /v1/status : disponibilité et incidents en cours de la plateforme.