Forge : faire évoluer l’API et ses outils ensemble
Générer plusieurs interfaces depuis les définitions
Le 28 septembre 2026, Cloudflare a présenté Forge, un générateur ouvert et extensible. Il produisait déjà des éléments pour la CLI cf ; son usage plus large pour les SDK et la documentation restait prévu.
Rendre les conséquences d’un changement visibles
Une API décrit comment un logiciel en appelle un autre. Une équipe doit souvent maintenir en parallèle le service, sa bibliothèque cliente et les exemples de documentation. Lorsque ces éléments divergent, un utilisateur peut suivre une procédure valide sur le papier mais inexécutable avec sa version installée.
L’intérêt d’une génération intégrée au travail de développement est de rendre la différence examinable avant publication. Une modification de paramètre devrait pouvoir être reliée à son effet dans le client et dans l’aide. Pour un agent qui utilise ces interfaces, un contrat cohérent réduit aussi les ambiguïtés d’appel.
Générer ne prouve pas le comportement
Un générateur peut propager fidèlement une définition incorrecte. Il faut donc conserver des vérifications sur le vrai service, des exemples exécutables et un contrôle des ruptures de compatibilité. Pour une petite API, le coût d’adoption doit être comparé au besoin réel de maintenir plusieurs sorties.
Rétrospective éditoriale : les faits sont datés dans le texte.