Візуалізатор специфікацій OpenAPI
Візуалізатор специфікацій OpenAPI допомагає швидко розібратися в незнайомому API; лінтер у CI не дає специфікації відхилятися від коду.
🔒 Цей інструмент працює повністю у вашому браузері. Ваші файли ніколи не завантажуються на сервер.
Розробник
Візуалізатор специфікацій OpenAPI
Попередній перегляд інтерфейсу — без завантаження та зовнішніх сервісів.
Карта ендпоінтів
Специфікацію на 2400 рядків відображено як 8 груп за тегами, що охоплюють 47 ендпоінтів, із 3 шляхами, позначеними без опису, та 2 схемами, визначеними, але ніколи не використаними.
Як працює візуалізатор специфікацій OpenAPI
- Вставте документ OpenAPI або Swagger у форматі JSON чи YAML.
- Групуйте за тегом, щоб побачити API так, як його організували автори, або за префіксом шляху для структури ресурсів.
- Шукайте ендпоінти без опису та схеми, на які ніщо не посилається — обидва є ознаками того, що специфікація відхилилась від реалізації.
FAQ
Які версії OpenAPI підтримуються?
Розбираються як OpenAPI 3.x, так і Swagger 2.0. Вони відрізняються тим, як оголошуються тіла запитів і безпека, що корисно знати, читаючи стару специфікацію поряд із новою.
Чи перевіряє це специфікацію?
Повідомляє про очевидні структурні проблеми, як-от схеми без посилань і відсутні описи. Повна перевірка відповідності специфікації потребує спеціалізованого лінтера на кшталт Spectral, який також застосовує власні стильові правила.
Чи завантажується моя специфікація?
Ні. Розбір відбувається в браузері, що важливо, коли специфікація описує внутрішній API та перелічує кожен його ендпоінт і поле.
Порівняння
| Функція | Online Tool Store | CLI-скрипт | Плагін для IDE |
|---|---|---|---|
| Нічого не завантажується | ✓ | ✗ | Залежить |
| Згрупований огляд | ✓ | ✓ | ✗ |
| Позначає невикористані схеми | ✓ | ✗ | ✗ |
| Не потребує встановлення | ✓ | ✗ | ✓ |
Візуалізатор специфікацій OpenAPI допомагає швидко розібратися в незнайомому API; лінтер у CI не дає специфікації відхилятися від коду.