Przeglądarka OpenAPI / Swagger

Renderuj dokument OpenAPI 3.0 / 3.1 lub Swagger 2.0 (YAML lub JSON) jako przeglądalne odniesienie API — informacje, serwery, ścieżki z tagami, parametry, przykłady treści żądań wygenerowane ze schematów, odpowiedzi i zabezpieczenia. Rozwiń dowolną operację, by użyć Wypróbuj i wysłać żywe żądanie z przeglądarki, albo wyeksportować ją jako cURL. Dokumenty są parsowane lokalnie; zdalne cele $ref i zewnętrzne schematy nie są pobierane (w pełni lokalnie). Wolisz interaktywny kreator żądań? Zobacz Klienta / testera REST API i całą rodzinę Narzędzi API.
Dokument OpenAPI / Swagger
Wypróbuj
Parametry
O tej przeglądarce: obsługuje Swagger 2.0 oraz OpenAPI 3.0 / 3.1. Odwołania są rozwiązywane wyłącznie wewnątrz dokumentu (#/components/schemas/…, #/definitions/…); zewnętrzne odwołania do plików lub adresów URL są zgłaszane, a nie pobierane. Wywołania Wypróbuj podlegają polityce CORS docelowego serwera — jeśli wywołanie zostanie zablokowane, użyj Konwertera cURL albo Klienta REST, aby uruchomić je spoza piaskownicy przeglądarki.
OpenAPI a Swagger, v2 a v3

Swagger był pierwotną nazwą narzędzi; gdy format specyfikacji przekazano Linux Foundation w 2015 roku, stał się OpenAPI, a Swagger żyje dalej jako marka narzędzi. Dokument składa się z info (metadane), paths (operacje dla każdego punktu końcowego) i components (wielokrotnego użytku schematy).

Klucz wersji mówi przeglądarce, którego parsera użyć: swagger: "2.0" kontra openapi: 3.0.x — w v3 treści żądań przeniesiono poza parametry i przyjęto prawdziwy JSON Schema.