OpenAPI-spec-visualizer
De OpenAPI Spec Visualizer is voor het snel doorgronden van een onbekende API; een linter in CI voorkomt dat de spec afdrijft van de code.
🔒 Deze tool werkt volledig in je browser. Je bestanden worden nooit naar een server geüpload.
Developer
OpenAPI Spec Visualizer
Frontend-voorbeeld — geen upload of externe dienst.
Endpointoverzicht
Een spec van 2.400 regels weergegeven als 8 taggroepen met 47 endpoints, waarbij 3 paden zijn gemarkeerd zonder samenvatting en 2 schema's zijn gedefinieerd maar nooit gerefereerd.
Hoe de OpenAPI Spec Visualizer werkt
- Plak het OpenAPI- of Swagger-document, in JSON of YAML.
- Groepeer op tag om de API te zien zoals de auteurs die hebben georganiseerd, of op pad-prefix voor de resourcestructuur.
- Let op endpoints zonder beschrijving en schema's waar niets naar verwijst — beide zijn tekenen dat de spec is afgedreven van de implementatie.
FAQ
Welke OpenAPI-versies werken?
Zowel OpenAPI 3.x als Swagger 2.0 worden geparst. Ze verschillen in hoe request bodies en security worden gedeclareerd, wat handig is om te weten bij het lezen van een oude spec naast een nieuwe.
Valideert dit de spec?
Het meldt duidelijke structurele problemen zoals ongerefereerde schema's en ontbrekende samenvattingen. Volledige validatie tegen de specificatie vereist een dedicated linter zoals Spectral, die ook huisstijlregels afdwingt.
Wordt mijn spec geüpload?
Nee. Het parsen gebeurt in de browser, wat belangrijk is wanneer de spec een interne API beschrijft en elk endpoint en veld daarin opsomt.
Vergelijking
| Functie | Online Tool Store | Een CLI-script | Een IDE-plugin |
|---|---|---|---|
| Niets wordt geüpload | ✓ | ✗ | Hangt ervan af |
| Gegroepeerd overzicht | ✓ | ✓ | ✗ |
| Markeert ongebruikte schema's | ✓ | ✗ | ✗ |
| Geen installatie | ✓ | ✗ | ✓ |
De OpenAPI Spec Visualizer is voor het snel doorgronden van een onbekende API; een linter in CI voorkomt dat de spec afdrijft van de code.