#designfirst — Public Fediverse posts
Live and recent posts from across the Fediverse tagged #designfirst, aggregated by home.social.
-
Design‑First в действии: API на Spring с OpenAPI Generator
Когда команда пишет API, но документация живёт своей жизнью, а интеграторы часами гадают, что значит ошибка 500, — проект неизбежно тонет в хаосе. В этой описан подход, который является лучшим решением: Design‑First на основе OpenAPI . Мы пройдём полный цикл: от проектирования спецификации до работающего Spring‑приложения с автоматической генерацией кода и централизованной обработкой ошибок. Вы узнаете, как одна команда ./gradlew clean build может создать модели и интерфейсы, избавив вас от рутины.
https://habr.com/ru/companies/otus/articles/1008384/
#api #openapi #spring #rest_api #swagger #spring_boot #designfirst #code_generation
-
Design‑First в действии: API на Spring с OpenAPI Generator
Когда команда пишет API, но документация живёт своей жизнью, а интеграторы часами гадают, что значит ошибка 500, — проект неизбежно тонет в хаосе. В этой описан подход, который является лучшим решением: Design‑First на основе OpenAPI . Мы пройдём полный цикл: от проектирования спецификации до работающего Spring‑приложения с автоматической генерацией кода и централизованной обработкой ошибок. Вы узнаете, как одна команда ./gradlew clean build может создать модели и интерфейсы, избавив вас от рутины.
https://habr.com/ru/companies/otus/articles/1008384/
#api #openapi #spring #rest_api #swagger #spring_boot #designfirst #code_generation
-
Design‑First в действии: API на Spring с OpenAPI Generator
Когда команда пишет API, но документация живёт своей жизнью, а интеграторы часами гадают, что значит ошибка 500, — проект неизбежно тонет в хаосе. В этой описан подход, который является лучшим решением: Design‑First на основе OpenAPI . Мы пройдём полный цикл: от проектирования спецификации до работающего Spring‑приложения с автоматической генерацией кода и централизованной обработкой ошибок. Вы узнаете, как одна команда ./gradlew clean build может создать модели и интерфейсы, избавив вас от рутины.
https://habr.com/ru/companies/otus/articles/1008384/
#api #openapi #spring #rest_api #swagger #spring_boot #designfirst #code_generation
-
Design‑First в действии: API на Spring с OpenAPI Generator
Когда команда пишет API, но документация живёт своей жизнью, а интеграторы часами гадают, что значит ошибка 500, — проект неизбежно тонет в хаосе. В этой описан подход, который является лучшим решением: Design‑First на основе OpenAPI . Мы пройдём полный цикл: от проектирования спецификации до работающего Spring‑приложения с автоматической генерацией кода и централизованной обработкой ошибок. Вы узнаете, как одна команда ./gradlew clean build может создать модели и интерфейсы, избавив вас от рутины.
https://habr.com/ru/companies/otus/articles/1008384/
#api #openapi #spring #rest_api #swagger #spring_boot #designfirst #code_generation
-
Nearly a decade into covering #DevOps, I'm still most fascinated by stories about how organizations approach #appmodernization and addressing #techdebt.
I had the opportunity recently to interview Ben Heil of Paylocity on that topic, and he shared insights into the product updates and development workflows that will help his teams move to #eventdriven #microservices and an #API #designfirst architecture.
-
Nearly a decade into covering #DevOps, I'm still most fascinated by stories about how organizations approach #appmodernization and addressing #techdebt.
I had the opportunity recently to interview Ben Heil of Paylocity on that topic, and he shared insights into the product updates and development workflows that will help his teams move to #eventdriven #microservices and an #API #designfirst architecture.
-
Nearly a decade into covering #DevOps, I'm still most fascinated by stories about how organizations approach #appmodernization and addressing #techdebt.
I had the opportunity recently to interview Ben Heil of Paylocity on that topic, and he shared insights into the product updates and development workflows that will help his teams move to #eventdriven #microservices and an #API #designfirst architecture.
-
Nearly a decade into covering #DevOps, I'm still most fascinated by stories about how organizations approach #appmodernization and addressing #techdebt.
I had the opportunity recently to interview Ben Heil of Paylocity on that topic, and he shared insights into the product updates and development workflows that will help his teams move to #eventdriven #microservices and an #API #designfirst architecture.
-
Nearly a decade into covering #DevOps, I'm still most fascinated by stories about how organizations approach #appmodernization and addressing #techdebt.
I had the opportunity recently to interview Ben Heil of Paylocity on that topic, and he shared insights into the product updates and development workflows that will help his teams move to #eventdriven #microservices and an #API #designfirst architecture.
-
@teixi @mamund @allenholub When adding a new API endpoint I start with writing an OpenAPI description and review, refine it with others. We are using the API description for request validation and parameter parsing. On production. We run response validation through the API description during testing.
This helps a lot to keep your docs and implementation aligned.
This #APIfirst #DesignFirst approach works nice and I would like more people to talk about it. -
Hey my ruby gem "openapi_first" just hit 100 stars 🌠 on Github. Yay!
openapi_first is a library to make sure your API implementation is aligned with your OpenAPI API description. And it also comes with a rack middleware to do request validation through your OpenAPI API description. Wow! 🚀
Feedback would be much appreciated. Please check it out at https://github.com/ahx/openapi_first
-
Design-first means that you describe your HTTP API (with OpenAPI) before writing any line of server code.
Now there are libraries to turn your API description into a request validation middleware. On production. With that, you not only have reduced the LOC required to implement the API, but also make sure that your API description matches your implementation. Great, right?I'd like to learn why most APIs still are not build that way. Any thoughts?
-
openapi_first is a Ruby gem for request / response validation and contract-testing against an OpenAPI API description. It makes APIFirst easy and reliable.
Version 2.0 has just been released. 🎉
New features:
- Hooks like `after_response_validation`, which you can use for metrics for example
- Test assertion method `assert_api_conform(status: 200)`
- Performance improvementsCheck it out: https://github.com/ahx/openapi_first?tab=readme-ov-file#openapi_first
CHANGELOG: https://github.com/ahx/openapi_first/blob/main/CHANGELOG.md