OpenAPI- / Swagger-viewer

Render een OpenAPI 3.0 / 3.1- of Swagger 2.0-document (YAML of JSON) tot een doorzoekbare API-referentie — info, servers, getagde paden, parameters, voorbeelden van verzoeklichamen die uit schema's zijn gegenereerd, antwoorden en beveiliging. Vouw elke bewerking uit voor Probeer het en stuur een live verzoek vanuit uw browser, of exporteer het als cURL. Documenten worden lokaal verwerkt; externe $ref-doelen en externe schema's worden niet opgehaald (volledig lokaal). Liever een interactieve verzoekeditor? Zie de REST API-client / -tester en de hele familie API-hulpmiddelen.
OpenAPI- / Swagger-document
Probeer het
Parameters
Over deze viewer: ondersteunt Swagger 2.0 en OpenAPI 3.0 / 3.1. Verwijzingen worden alleen binnen het document opgelost (#/components/schemas/…, #/definitions/…); externe bestands- of URL-verwijzingen worden gemeld in plaats van opgehaald. Probeer het-aanroepen vallen onder het CORS-beleid van de doelserver — als een aanroep wordt geblokkeerd, gebruik dan de cURL-converter of de REST-client om hem van buiten de browsersandbox uit te voeren.
OpenAPI versus Swagger, v2 versus v3

Swagger was de oorspronkelijke naam van de tooling; toen het specificatieformaat in 2015 aan de Linux Foundation werd geschonken, werd het OpenAPI, en Swagger leeft voort als toolingmerk. Een document is opgebouwd uit info (metadata), paths (bewerkingen per eindpunt) en components (herbruikbare schema's).

De versiesleutel vertelt viewers welke parser ze moeten gebruiken: swagger: "2.0" tegenover openapi: 3.0.x — v3 heeft verzoeklichamen uit parameters gehaald en echt JSON Schema overgenomen.