Автогенерация документации на основе роутинга. Для всех популярных фреймворков есть пакеты.
Меня смущает обилие спецификации в исходном коде каждого роута. Выносите в отдельные модули?
Это как? Где можно почитать про это ?
fastify
Желательно вынесли все по отдельным папкам. controller.ts service.ts entities/ interfaces/ schemas/ Соответственно схемы держите отдельно. Для валидации и документации. Поверьте, это намного лучший способ, чем придумали в express или nestjs.
Если у меня api gateway который на каждый роут делает просто reply.from(url), то всё кроме схем делать не имеет смысла, верно?
Если роут прокси - то его все равно желательно как-то описать.
Я хочу api всего приложения описать в api gateway, как будто он по урлам реально выполняет логику, но на самом деле ее проксировать. Возможные проблемы планирую решать через через dredd
И как это влияет на описание API? Вы с таким же успехом могли GraphQL подвезти.
Обсуждают сегодня