Aller au contenu principal
ApiGlow v0.3.0
FR

Les notes de version, depuis le premier jour.

Une entrée par version, reprise des notes de release de l’app. La démo tourne sur le bundle publié, celui-là même qu’installe le snippet présent sur chaque page.

  1. 0.3.0

    2026-10-02
    • apiglow audit : l’audit du schéma comme contrôle de CI — npx apiglow audit openapi.yaml fait échouer le build sur un constat d’une sévérité donnée, une note ou un score sous votre seuil
    • Une baseline versionnée permet à une API existante de n’échouer que sur les nouveaux constats, et une entrée périmée fait échouer le passage pour ne jamais masquer une régression
    • Des rapports là où regardent les relecteurs : SARIF pour le code scanning de GitHub, annotations sur la pull request, GitLab Code Quality, Markdown pour le résumé du job, JSON versionné pour les scripts et les agents — chaque constat en fichier:ligne:colonne
    • L’action GitHub apiglow/audit-action fait tout en une étape, et le paquet livre une skill d’agent qui audite, corrige et audite à nouveau
    • 137 règles d’audit en sept catégories : la structure confrontée à la spécification OpenAPI version par version, plus deux nouvelles catégories, sécurité et préparation aux agents
    • Chaque constat dit comment le corriger ; les règles s’éteignent ou changent de sévérité dans un bloc audit de la config, lu par la page comme par la CLI ; un fichier abîmé a quand même son rapport, ses erreurs de syntaxe placées à leur ligne
    • L’audit ne se charge que quand on l’ouvre, et sa page s’ouvre sur le verdict
    • <Cards>, <Steps> et <Tabs> dans les pages de prose, et des liens apidoc:page/{slug} entre elles — sans MDX, rien n’est compilé
    • Les valeurs d’enum portent leur sens (x-enum-descriptions, x-enumDescriptions, ou un oneOf de constantes décrites)
    • Un menu « Copier pour l’IA » dans l’en-tête de chaque page ; les pages d’endpoint se lisent comme une requête et une réponse
    • Console d’essai : les en-têtes et méthodes que le navigateur refuse sont nommés, les variables de serveur sont remplies, les URL relatives se résolvent par rapport au schéma, les secrets en base64 restent masqués

  2. 0.2.0

    2026-08-16
    • Annonces : un bandeau au-dessus de la documentation pour dire ce que le schéma ne peut pas dire — une fenêtre de maintenance, une date de dépréciation, une version qui vient de sortir
    • Déclarez-les inline, ou pointez announcements vers un fichier que vos ops éditent sans redéployer la page hôte ; startsAt / endsAt publient et retirent un message tout seuls
    • L’en-tête tient sur une ligne à toutes les tailles d’écran, téléphone compris : thème, langue, réglages et « À propos » passent dans un seul menu de préférences
    • La recherche est dans l’en-tête à toutes les largeurs — une icône sur téléphone, un champ à partir de la tablette
    • Sur téléphone, le bouton « Essayer » s’efface pendant qu’on descend, et les raccourcis clavier ne sont annoncés qu’aux appareils qui ont un clavier
    • La barre de crédit en bas de page disparaît, et avec elle branding.footerLinks ; « À propos », avec la licence et les mentions tierces, vit dans le menu de l’en-tête
    • Corrections sur téléphone : plus de défilement latéral dû au sélecteur de spec, dialogues décollés des bords, et une navigation qui ouvre la nouvelle page en haut

  3. 0.1.0

    2026-08-15
    • Documentation interactive générée dans le navigateur depuis OpenAPI 3.0.x–3.2.x — ou Swagger 2.0, converti au chargement
    • Console d’essai : formulaires pilotés par le schéma, environnements avec interpolation {{var}} et blocage d’envoi, OAuth2 PKCE entièrement dans le navigateur
    • Historique des requêtes avec relecture ; exports cURL, Postman v2.1, Markdown et HAR (secrets caviardés par défaut) — et import cURL/Postman/HAR
    • Scénarios déclaratifs avec rapport « tout exécuter », mode tutoriel pas à pas, et import/export Arazzo 1.1
    • Audit de schéma dans le navigateur : 38 règles, note en lettre, rapport Markdown
    • Multi-spec avec isolation par spec ; OpenAPI Overlay 1.1 appliqué au chargement ; masquage d’endpoints
    • Un lecteur peut corriger le schéma en local avec son propre document Overlay 1.1, et le télécharger pour le remonter à l’amont
    • Les pages de prose résolvent {{var}} depuis l’environnement du lecteur ; les valeurs sensibles s’affichent masquées et ne sortent jamais
    • Un environnement voyage en setup link — partagé depuis le gestionnaire, ou fabriqué de zéro sans le créer
    • 35 thèmes daisyUI plus des thèmes maison déclarés en config ; interface en anglais et en français
    • Génération de llms.txt, llms-full.txt et d’une config MCP — deux ponts OpenAPI→MCP au choix
    • Un workflow, trois lecteurs : un scénario se remet en job GitHub Actions ou GitLab CI généré, des secrets en noms seulement
    • apiglow bake : miroirs statiques HTML et Markdown, sitemap et llms.txt servi, en une commande côté auteur