OpenAPI- / Swagger-visare

Rendera ett OpenAPI 3.0 / 3.1- eller Swagger 2.0-dokument (YAML eller JSON) till en bläddringsbar API-referens — info, servrar, taggade sökvägar, parametrar, exempel för begärandekroppar genererade från scheman, svar och säkerhet. Expandera valfri operation för att Prova och skicka en live-begäran från webbläsaren, eller exportera den som cURL. Dokument tolkas lokalt; fjärrmål för $ref och externa scheman hämtas inte (helt lokalt). Om en interaktiv begäranskomponerare önskas i stället: se REST API-klienten / testaren och hela API-verktygsfamiljen.
OpenAPI / Swagger-dokument
Testa
Parametrar
Om denna visare: stöder Swagger 2.0 och OpenAPI 3.0 / 3.1. Referenser löses endast inom dokumentet (#/components/schemas/…, #/definitions/…); externa fil- eller URL-referenser rapporteras i stället för att hämtas. Anrop under Prova omfattas av målserverns CORS-policy — om ett anrop blockeras, använd cURL-omvandlaren eller REST-klienten för att köra det utanför webbläsarens sandlåda.
OpenAPI vs Swagger, v2 vs v3

Swagger var det ursprungliga verktygsnamnet; när specifikationsformatet donerades till Linux Foundation 2015 blev det OpenAPI, och Swagger lever vidare som ett verktygsvarumärke. Ett dokument byggs från info (metadata), paths (operationer per slutpunkt) och components (återanvändbara scheman).

Versionsnyckeln talar om för visaren vilken parser som ska användas: swagger: "2.0" jämfört med openapi: 3.0.x — v3 flyttade begärandekroppar från parametrar och antog ett riktigt JSON-schema.