Visualizzatore OpenAPI / Swagger

Visualizzi un documento OpenAPI 3.0 / 3.1 o Swagger 2.0 (YAML o JSON) come riferimento API navigabile — info, server, percorsi raggruppati per tag, parametri, esempi del corpo della richiesta generati dagli schemi, risposte e sicurezza. Espanda qualsiasi operazione per Prova e invii una richiesta reale dal suo browser, oppure la esporti come cURL. I documenti vengono analizzati localmente; i riferimenti $ref remoti e gli schemi esterni non vengono recuperati (tutto è locale). Preferisce un compositore di richieste interattivo? Veda il Client / Tester REST API e l'intera famiglia di Strumenti API.
Documento OpenAPI / Swagger
Prova
Parametri
Informazioni su questo visualizzatore: supporta Swagger 2.0 e OpenAPI 3.0 / 3.1. I riferimenti vengono risolti solo all'interno del documento (#/components/schemas/…, #/definitions/…); i riferimenti a file o URL esterni vengono segnalati e non recuperati. Le chiamate di Prova sono soggette alla politica CORS del server di destinazione — se una chiamata viene bloccata, usi il Convertitore cURL oppure il Client REST per eseguirla dall'esterno del sandbox del browser.
OpenAPI contro Swagger, v2 contro v3

Swagger era il nome originale dello strumento; quando il formato della specifica è stato donato alla Linux Foundation nel 2015 è diventato OpenAPI, e Swagger sopravvive come marchio di strumenti. Un documento è costruito da info (metadati), paths (operazioni per endpoint) e components (schemi riutilizzabili).

La chiave di versione indica ai visualizzatori quale parser usare: swagger: "2.0" rispetto a openapi: 3.0.x — la v3 ha spostato i corpi delle richieste fuori dai parametri e ha adottato il vero JSON Schema.