# Une balise script, documentée de bout en bout.

> Installer ApiGlow, écrire la config et publier une doc OpenAPI interactive : les guides — installation, configuration, CORS, thèmes, scénarios.
>
> Source: https://apiglow.dev/fr/docs/index.md


ApiGlow génère une documentation d'API interactive à l'exécution, dans le navigateur, depuis un schéma OpenAPI. Une page HTML, une config JSON inline, un `<script>` servi par un CDN — pas d'étape de build, pas de backend, pas de compte. [La démo](/demo/) montre ce que ça donne ; les guides ci-dessous couvrent le reste.

{{< install-snippet >}}

Commencez par l'[installation](/fr/docs/install/). La [référence de configuration](/fr/docs/configuration/) liste chaque clé avec sa valeur par défaut, et les autres guides creusent chacun un sujet.

## Ce que le moteur accepte

| Format | Prise en charge |
|---|---|
| OpenAPI 3.0.x / 3.1.x / 3.2.x | Rendu natif, webhooks et callbacks compris |
| Swagger 2.0 | Converti au chargement |
| OpenAPI Overlay 1.1 | Appliqué au schéma au chargement |
| Arazzo 1.0 / 1.1 | Les scénarios importent les deux et exportent du 1.1.0, et se remettent à la CI en job généré |
| JSON Schema 2020-12 | Mots-clés rendus dans les vues de schéma |

Le détail — conversion, overlays, masquage, changelog local — vit dans [Couverture OpenAPI & contrôle du schéma](/fr/docs/schema-support/).


- [Installer ApiGlow](https://apiglow.dev/fr/docs/install/index.md): Installer ApiGlow en une balise script : le snippet canonique, openapi.url ou openapi.spec, l'auto-hébergement depuis npm, et un prompt pour votre agent.
- [Référence de configuration](https://apiglow.dev/fr/docs/configuration/index.md): La référence complète de la config ApiGlow : chaque clé du bloc JSON inline, sa valeur par défaut, et les règles de surcharge par spec.
- [Guide des thèmes](https://apiglow.dev/fr/docs/theming/index.md): Habiller ApiGlow à vos couleurs sans étape de build : une entrée de config ou un bloc CSS, la sortie du générateur de thèmes daisyUI collée telle quelle.
- [Guide de la console d'essai](https://apiglow.dev/fr/docs/try-it/index.md): La console d'essai en profondeur : formulaires issus du schéma, sérialisation des paramètres, imports et exports, historique rejouable, diagnostic réseau.
- [Console d'essai & CORS](https://apiglow.dev/fr/docs/cors/index.md): Pourquoi le navigateur bloque un appel d'essai, comment ApiGlow diagnostique l'échec, et les issues : CORS côté API, proxy auto-hébergé, cookies.
- [Authentification & onboarding](https://apiglow.dev/fr/docs/auth/index.md): Brancher les identifiants dans la console d'essai — securitySchemes, OAuth2 PKCE sans backend — et accueillir un coéquipier avec un setup link d'environnement.
- [Écrire des scénarios](https://apiglow.dev/fr/docs/scenarios/index.md): Écrire des scénarios ApiGlow sans toucher au JSON : capture depuis la console, chaînage en cliquant la réponse, livraison via la config, remise à votre CI.
- [Guide des pages de prose](https://apiglow.dev/fr/docs/docs-pages/index.md): Déclarer des guides Markdown dans la config ApiGlow : callouts, onglets de code, cartes d'opération, interpolation {{var}}, frises de versions, avis.
- [Guide multi-spec](https://apiglow.dev/fr/docs/multi-spec/index.md): Documenter plusieurs API avec une seule installation ApiGlow : déclarer openapi.specs, surcharger la config par spec, compter sur l'isolation totale.
- [Couverture OpenAPI & contrôle du schéma](https://apiglow.dev/fr/docs/schema-support/index.md): Ce que le moteur lit — OpenAPI 3.0 à 3.2, Swagger 2.0, webhooks — et comment le façonner : Overlay 1.1, correctif côté lecteur, masquage, changelog local.
- [Guide de l'audit de schéma](https://apiglow.dev/fr/docs/audit/index.md): L'audit OpenAPI : 137 règles en sept catégories, sécurité et agents compris, le calcul de la note, la configuration des règles, le rapport Markdown.
- [L'audit en CI](https://apiglow.dev/fr/docs/audit-ci/index.md): apiglow audit en CI : faire échouer un build sur les constats du schéma, l'adopter avec une baseline, alimenter GitHub, GitLab et SARIF.
- [llms.txt et MCP](https://apiglow.dev/fr/docs/ai/index.md): Ouvrez votre doc d'API aux agents : llms.txt et llms-full.txt générés dans le navigateur, une config MCP, un menu Copier pour l'IA sur chaque page.
- [SEO & CLI bake](https://apiglow.dev/fr/docs/seo/index.md): Titres et JSON-LD par route à l'exécution, et apiglow bake : miroir statique HTML et Markdown, sitemap et llms.txt servi, pour les crawlers et les agents.
- [Référence complète](https://apiglow.dev/fr/docs/full-reference/index.md): Toutes les clés de la config ApiGlow en un seul objet copiable, un commentaire par clé : la surface entière telle qu’elle vit dans la page hôte.
- [Questions fréquentes](https://apiglow.dev/fr/docs/faq/index.md): Les réponses courtes sur ApiGlow : licence, confidentialité, versions OpenAPI, auto-hébergement depuis npm, taille du bundle, CORS, marque, SEO et crawlers.
- [Builder de configuration](https://apiglow.dev/fr/docs/builder/index.md): Assemblez une configuration ApiGlow complète dans la page : votre schéma, votre thème daisyUI avec aperçu en direct et audit de contraste, puis l’installation.