Visualiseur de spec OpenAPI
Le Visualiseur de spec OpenAPI sert à comprendre rapidement une API inconnue ; un linter en CI est ce qui empêche la spec de dériver du code.
🔒 Cet outil fonctionne entièrement dans votre navigateur. Vos fichiers ne sont jamais envoyés sur un serveur.
Développeur
Visualiseur de spec OpenAPI
Aperçu frontend — aucun envoi ni service externe.
Carte des endpoints
Une spec de 2 400 lignes rendue sous forme de 8 groupes de tags couvrant 47 endpoints, avec 3 chemins signalés sans résumé et 2 schémas définis mais jamais référencés.
Comment fonctionne le Visualiseur de spec OpenAPI
- Collez le document OpenAPI ou Swagger, en JSON ou YAML.
- Groupez par tag pour voir l'API telle que ses auteurs l'ont organisée, ou par préfixe de chemin pour voir la structure des ressources.
- Repérez les endpoints sans description et les schémas que rien ne référence — deux signes que la spec a dérivé de l'implémentation.
FAQ
Quelles versions d'OpenAPI fonctionnent ?
OpenAPI 3.x et Swagger 2.0 sont tous deux analysés. Les deux diffèrent dans la façon dont les corps de requête et la sécurité sont déclarés, ce qui vaut la peine d'être su en lisant une ancienne spec à côté d'une nouvelle.
Cela valide-t-il la spec ?
Il signale des problèmes structurels évidents comme des schémas non référencés et des résumés manquants. Une validation complète par rapport à la spécification nécessite un linter dédié comme Spectral, qui impose aussi des règles de style maison.
Ma spec est-elle envoyée en ligne ?
Non. L'analyse se fait dans le navigateur, ce qui compte quand la spec décrit une API interne et liste chaque endpoint et champ qu'elle contient.
Comparaison
| Fonctionnalité | Online Tool Store | Un script CLI | Un plugin IDE |
|---|---|---|---|
| Rien n'est envoyé | ✓ | ✗ | Selon le cas |
| Vue groupée | ✓ | ✓ | ✗ |
| Signale les schémas inutilisés | ✓ | ✗ | ✗ |
| Aucune installation | ✓ | ✗ | ✓ |
Le Visualiseur de spec OpenAPI sert à comprendre rapidement une API inconnue ; un linter en CI est ce qui empêche la spec de dériver du code.