Обновить

OpenAPI спецификация как инструмент frontend-разработчика: практическое применение и типичные проблемы

Уровень сложностиСредний
Время на прочтение20 мин
Охват и читатели5.3K
Всего голосов 1: ↑1 и ↓0+2
Комментарии1

Комментарии 1

Добавлю к валидации спецификации: её стоит проверять в CI тем же линтером, что и на бэкенде, например Spectral или redocly lint. Иначе фронт узнаёт о сломанной схеме только при генерации типов.

Есть ещё одна типичная проблема: спецификация расходится с реальными ответами. В схеме поле обязательное, а сервер иногда отдаёт null, и сгенерированные типы врут. Это ловится сравнением живых ответов со схемой в интеграционных тестах. Вы доверяете спецификации или проверяете ответы отдельно?

Зарегистрируйтесь на Хабре, чтобы оставить комментарий

Публикации