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

REST APIs are great. Until they are not.

OpenSearch now supports native gRPC endpoints with Protocol Buffer schemas, giving teams a high-performance alternative to JSON-based REST without having to give up REST entirely.

Both protocols run in parallel. Adopt at your own pace. https://opensearch.org/blog/advancing-opensearch-with-grpc-and-protocol-buffers/

APIs #gRPC #OpenAPI

Don't like warnings in your #Java build? Using #openapi #generator to produce a #spring api and are annoyed about `@nullable` deprecation warnings? Add this mapping to use #JSpecify:

https://github.com/neo4j/neo4j-jdbc/commit/05da142103db0631b34a7af19dc1f62412a49e85

"To begin with, everything you document has to be in a format that's as structured and machine-readable as possible. The key here is to disambiguate as much as you can, even if you have to repeat yourself. So, don't bother with the formatting of your documentation or the look and feel of your API portal. Instead, focus on using well-known API definition standards based on machine-readable formats. Use OpenAPI for documenting REST APIs, AsyncAPI for asynchronous APIs, Protocol Buffers for gRPC, and the GraphQL Schema Definition Language. Whenever possible, store the API definitions in several formats, such as JSON and YAML, for easy interpretation by AI agents.

But that's not enough. If you don't have all your operations clearly defined, AI agents will have a hard time understanding what they can do. Make sure you clearly define all operation parameters. Specify what the input types are so there are no misunderstandings. So, instead of saying that everything is a "string," identify each individual input format."

https://apichangelog.substack.com/p/api-documentation-for-machines

#APIs #APIDocumentation #AI #AIAgents #LLMs #OpenAPI #TechnicalWriting #SoftwareDocumentation #Programming

[Перевод] Вас заменит ИИ? Нет. И вот одна причина, которую не получится обойти

После « апокалипсиса SaaS » рынок впал в лихорадку. Инвесторы решили, что программное обеспечение стало практически бесплатным товаром и 90% программистов можно уволить. Это одно из предсказуемых заблуждений, вызванных непониманием природы разработки ПО. Да, правила игры изменились, и SaaS больше не будет таким, каким был. Но ИИ его не уничтожит и не заменит разработчиков приложений. SaaS неизбежен, каким бы впечатляющим ни был ИИ. Потому что SaaS — это не просто доступ к программному обеспечению. SaaS — это критически важная инфраструктура вокруг кода. Он обеспечивает хранение данных, резервное копирование, контроль доступа, интеграции, обновления, масштабирование, безопасность и комплаенс. Исчезновение SaaS означало бы не свободу от оплаты софта, а возврат в архаичную эпоху. Компаниям пришлось бы разворачивать собственные серверные, строить внутренние дата-центры, организовывать обновления и бэкапы, нанимать обслуживающий персонал. Нет оснований полагать, что кто-то этого хочет. Однако потребность в инфраструктуре — лишь одна причина, по которой ИИ не перевернёт нынешние практики разработки ПО. Другая — в том, что он не способен воплотить один незадокументированный фундаментальный инженерный принцип. Позвольте объяснить.

https://habr.com/ru/companies/bothub/articles/1013510/

#ии #нейросети #машинное+обучение #ai #openapi #программирование #google

Current status: #OpenAPI

Just ignore any abnormal grumbling sounds you may hear.