Заменили Swagger на альтернативный инструмент для отображения документации - Stoplight
Замена не требует внесения правок в сам OAS, Для обновления повторите эти PR: раз и два
Плюс путь изменился с /docs/swagger на /docs/oas, например: https://admin-gui-backend-master-dev.ensi.tech/docs/oas/
Какие у Stoplight преимущества:
1. Основная причина - поддержка рекурсивных связей (т.е. Delivery.order == Order + Order.delivery == Delivery). Swagger на таких отображал ошибку и документация становилась недоступна
2. Пример curl запроса можно скопировать сразу, без необходимости выполнять запрос
3. Без переключения по табам видны и пример запроса в json, и описание структуры
4. Быстрее загружается - особенно заметно на админке, где много эндпоинтов: 0,5с против 5с
Замена не требует внесения правок в сам OAS, Для обновления повторите эти PR: раз и два
Плюс путь изменился с /docs/swagger на /docs/oas, например: https://admin-gui-backend-master-dev.ensi.tech/docs/oas/
Какие у Stoplight преимущества:
1. Основная причина - поддержка рекурсивных связей (т.е. Delivery.order == Order + Order.delivery == Delivery). Swagger на таких отображал ошибку и документация становилась недоступна
2. Пример curl запроса можно скопировать сразу, без необходимости выполнять запрос
3. Без переключения по табам видны и пример запроса в json, и описание структуры
4. Быстрее загружается - особенно заметно на админке, где много эндпоинтов: 0,5с против 5с
