Prehliadač OpenAPI / Swagger

Vykreslí dokument OpenAPI 3.0 / 3.1 alebo Swagger 2.0 (YAML alebo JSON) ako prehliadateľnú referenciu API — info, servery, označené cesty, parametre, príklady tela požiadavky generované zo schém, odpovede a zabezpečenie. Ľubovoľnú operáciu možno rozbaliť na Vyskúšať a poslať živú požiadavku z prehliadača alebo ju exportovať ako cURL. Dokumenty sa spracúvajú lokálne; vzdialené ciele $ref a externé schémy sa nesťahujú (úplne lokálne). Ak sa hľadá interaktívny tvorca požiadaviek, slúži na to Klient REST API / Tester a celá rodina nástrojov API.
Dokument OpenAPI / Swagger
Vyskúšať
Parametre
O tomto prehliadači: podporuje Swagger 2.0 a OpenAPI 3.0 / 3.1. Odkazy sa rozlišujú len vnútri dokumentu (#/components/schemas/…, #/definitions/…); externé odkazy na súbory alebo URL sa iba nahlásia a nesťahujú sa. Vyskúšať volania podliehajú politike CORS cieľového servera — ak je volanie zablokované, na jeho spustenie mimo pieskoviska prehliadača slúži Konvertor cURL alebo Klient REST.
OpenAPI vs. Swagger, v2 vs. v3

Swagger bol pôvodný názov nástrojov; keď bol formát špecifikácie v roku 2015 darovaný Linux Foundation, stal sa OpenAPI a Swagger ostal ako značka nástrojov. Dokument sa skladá z info (metaúdaje), paths (operácie pre každý koncový bod) a components (opakovane použiteľné schémy).

Kľúč verzie hovorí prehliadaču, ktorý analyzátor použiť: swagger: "2.0" oproti openapi: 3.0.x — v3 presunulo telá požiadaviek z parametrov a prijalo skutočnú schému JSON.