Vai al contenuto
100% locale

Listare gli endpoint OpenAPI

Enumera ogni endpoint di un documento OpenAPI o Swagger in una tabella leggibile.

Ingresso
Uscita

Listare gli endpoint OpenAPI

Incolla un documento OpenAPI o Swagger — JSON o YAML, OpenAPI 3 o Swagger 2 — e questo strumento estrae ogni endpoint in un elenco leggibile. È progettato per quando ricevi un file di specifica e hai bisogno di una rapida panoramica prima di addentrarsi nei dettagli: quali rotte esistono, cosa richiedono e cosa restituiscono.

Filtra l'elenco per metodo HTTP o per tag per concentrarti su una parte dell'API. Attiva e disattiva i parametri di percorso e query, il tipo di contenuto del corpo della richiesta, i codici di risposta e se un endpoint richiede l'autenticazione — lo strumento legge i requisiti di sicurezza per operazione, ricorrendo alle impostazioni di sicurezza globali del documento se un'operazione non le sostituisce. Attiva « Saltare gli endpoint deprecated » per nascondere le rotte contrassegnate come deprecated nella specifica e includi il campo di riepilogo di ogni endpoint per contesto aggiuntivo senza aprire il file di origine.

Ordina il risultato per percorso o per tag, e scegli un formato di output che corrisponda a ciò che ti serve dopo: un elenco semplice per una rapida scansione, una tabella Markdown da incollare nella documentazione o una pull request, o CSV da aprire in un foglio di calcolo. I parametri definiti con $ref invece che inline vengono saltati piuttosto che indovinati, poiché la corretta risoluzione di un riferimento richiede il resto del documento.

Tutto viene eseguito localmente nel tuo browser — la specifica dell'API non abbandona mai il tuo dispositivo, il che è importante quando descrive un servizio interno o non rilasciato. Copia il risultato, scaricalo come file .txt oppure invialo direttamente a un altro strumento per continuare.

FAQ

Supporta sia OpenAPI 3 che Swagger 2?
Sì. Entrambi i formati mantengono gli endpoint in una sezione "paths" con la stessa struttura, quindi lo stesso lettore gestisce entrambe le versioni.
Come decide se un endpoint richiede l'autenticazione?
Controlla innanzitutto il campo "security" dell'operazione. Un array vuoto lì significa che quell'endpoint disattiva esplicitamente l'autenticazione; se il campo è assente, lo strumento ricorre all'impostazione globale "security" del documento.
Può risolvere i riferimenti $ref?
No per i parametri — un parametro definito con $ref non ha un nome inline, quindi viene saltato invece che risolto, poiché ciò richiederebbe la lettura del resto del documento.
Cosa succede con un documento non valido o non correlato?
Vedrai un messaggio chiaro: uno per il testo che non è JSON o YAML valido, e un altro quando il documento viene analizzato correttamente ma non ha una sezione "paths".
La mia specifica API viene caricata da qualche parte?
No. L'analisi e la formattazione avvengono interamente nel tuo browser — il documento che incolli non abbandona mai il tuo dispositivo.