Prohlížeč OpenAPI / Swagger

Vykreslí dokument OpenAPI 3.0 / 3.1 nebo Swagger 2.0 (YAML nebo JSON) jako procházitelnou referenci API — info, servery, označené cesty, parametry, příklady těl požadavků generované ze schémat, odpovědi a zabezpečení. Rozbalte libovolnou operaci a klikněte na Vyzkoušet, odešlete živý požadavek z prohlížeče, nebo jej exportujte jako cURL. Dokumenty se zpracovávají lokálně; vzdálené cíle $ref a externí schémata se nestahují (vše je lokální). Chcete raději interaktivní tvůrce požadavků? Viz Klient / tester REST API a celou rodinu nástrojů pro API.
Dokument OpenAPI / Swagger
Vyzkoušet
Parametry
O tomto prohlížeči: podporuje Swagger 2.0 a OpenAPI 3.0 / 3.1. Odkazy se řeší pouze uvnitř dokumentu (#/components/schemas/…, #/definitions/…); externí odkazy na soubory nebo URL se hlásí, ale nestahují se. Volání Vyzkoušet podléhá politice CORS cílového serveru — pokud je volání blokováno, použijte převodník cURL nebo REST Client ke spuštění mimo sandbox prohlížeče.
OpenAPI vs Swagger, verze 2 vs 3

Swagger byl původní název nástroje; když byl formát specifikace v roce 2015 věnován nadaci Linux Foundation, stal se OpenAPI a Swagger přežívá jako značka nástrojů. Dokument se skládá z info (metadata), paths (operace pro každý koncový bod) a components (znovupoužitelná schémata).

Klíč verze říká prohlížeči, který parser použít: swagger: "2.0" oproti openapi: 3.0.x — verze 3 přesunula těla požadavků z parametrů a přijala skutečné JSON Schema.