OpenAPI спецификация как инструмент frontend-разработчика: практическое применение и типичные проблемы
Спецификация OpenAPI может быть полезна фронтендеру задолго до открытия Swagger UI. Из неё можно получить TypeScript-типы, API-клиент и mock-сервер — и начать разработку, пока бэкенд ещё не готов. Вместо ручного описания моделей и запросов — генерация из одного контракта. Но что делать, если в контракте опечатка, лишние эндпоинты или поле, которого пока нет в спецификации, хотя оно уже нужно в интерфейсе? Ручные исправления живут до следующего обновления файла, а ждать изменений на бэкенде получается не всегда. В статье разберём рабочие примеры с RTK Query, React Query, нативным fetch и Express, а затем соберём воспроизводимую подготовку спецификации через openapi-modifier. Покажу, как хранить исправления отдельными правилами и применять их заново при каждом обновлении OpenAPI. Читать далее