Переглядач OpenAPI / Swagger

Відобразіть документ OpenAPI 3.0 / 3.1 або Swagger 2.0 (YAML або JSON) як довідник API, що переглядається: інформація, сервери, позначені шляхи, параметри, приклади тіл запитів, згенеровані зі схем, відповіді та безпека. Розгорніть будь-яку операцію, щоб Спробувати і надіслати живий запит із вашого браузера, або експортуйте її як cURL. Документи розбираються локально; віддалені цілі $ref і зовнішні схеми не завантажуються (повністю локально). Якщо потрібен інтерактивний конструктор запитів, дивіться Клієнт / тестувальник REST API та всю родину Інструментів API.
Документ OpenAPI / Swagger
Спробувати
Параметри
Про переглядач: підтримує Swagger 2.0 та OpenAPI 3.0 / 3.1. Посилання розв'язуються лише всередині документа (#/components/schemas/…, #/definitions/…); зовнішні посилання на файли або URL повідомляються, а не завантажуються. Виклики Спробувати підлягають політиці CORS цільового сервера — якщо виклик блокується, скористайтеся конвертером cURL або REST Client, щоб виконати його поза пісочницею браузера.
OpenAPI проти Swagger, v2 проти v3

Swagger був початковою назвою інструментів; коли специфікацію передали Linux Foundation у 2015, вона стала OpenAPI, а Swagger залишився брендом інструментів. Документ складається з info (метадані), paths (операції для кожного endpoint) і components (повторно використовувані схеми).

Ключ версії підказує переглядачу, який парсер використати: swagger: "2.0" проти openapi: 3.0.x — v3 перенесла тіла запитів з параметрів і прийняла справжній JSON Schema.