Visualizzatore di spec OpenAPI
Il Visualizzatore di spec OpenAPI serve a capire in fretta un'API sconosciuta; un linter in CI è ciò che evita che la spec si allontani dal codice.
🔒 Questo strumento funziona interamente nel tuo browser. I tuoi file non vengono mai caricati su un server.
Sviluppatore
Visualizzatore di spec OpenAPI
Anteprima frontend — nessun caricamento né servizio esterno.
Mappa degli endpoint
Una spec di 2.400 righe resa come 8 gruppi per tag che coprono 47 endpoint, con 3 percorsi segnalati senza riepilogo e 2 schemi definiti ma mai referenziati.
Come funziona il Visualizzatore di spec OpenAPI
- Incolla il documento OpenAPI o Swagger, in JSON o YAML.
- Raggruppa per tag per vedere l'API come l'hanno organizzata i suoi autori, o per prefisso del percorso per vedere la struttura delle risorse.
- Cerca endpoint senza descrizione e schemi che nulla referenzia — entrambi segni che la spec si è allontanata dall'implementazione.
FAQ
Quali versioni OpenAPI funzionano?
Vengono analizzati sia OpenAPI 3.x sia Swagger 2.0. I due differiscono nel modo in cui dichiarano i corpi delle richieste e la sicurezza, cosa utile da sapere leggendo una spec vecchia accanto a una nuova.
Questo valida la spec?
Segnala problemi strutturali evidenti come schemi non referenziati e riepiloghi mancanti. La validazione completa rispetto alla specifica richiede un linter dedicato come Spectral, che impone anche regole di stile interne.
La mia spec viene caricata?
No. L'analisi avviene nel browser, il che conta quando la spec descrive un'API interna ed elenca ogni endpoint e campo al suo interno.
Confronto
| Funzione | Online Tool Store | Uno script CLI | Un plugin IDE |
|---|---|---|---|
| Niente viene caricato | ✓ | ✗ | Dipende |
| Vista raggruppata | ✓ | ✓ | ✗ |
| Segnala schemi inutilizzati | ✓ | ✗ | ✗ |
| Nessuna installazione | ✓ | ✗ | ✓ |
Il Visualizzatore di spec OpenAPI serve a capire in fretta un'API sconosciuta; un linter in CI è ciò che evita che la spec si allontani dal codice.