SpringDoc is a really cool tool that lets you generate #OpenAPI 3.1 specification files from any #Spring app, all you need to do is add annotations. To help you get started, @Philsturgeon has put together this excellent guide:

https://bump.sh/blog/generating-openapi-docs-for-java-with-spring-boot/?utm_source=mastodon&utm_medium=social&utm_campaign=spring_boot_guide&utm_content=bump

A quick bit of #java #OpenAPI generator customisation: removing the annoyingly verbose Generated annotation.

https://blog.melnib.one/2025/06/20/remove-@generated-annotations-when-using-the-openapi-client-generator/

Finally got @meow running on a #mastodon API client generated from an #openapi spec.

openapi_first 2.8.0 will make it very simple to turn your existing integration tests into contract tests against an OpenAPI API description. No extra middlewares. No custom test assertions.

#ruby #openapi #openapi_first

🚀 Dive deep into the ocean of #OpenAPI and discover an endless parade of #buzzwords and integrations you never asked for. 🌊 Let's "seamlessly" discuss the 42 ways to deploy from #GitHub, #GitLab, and other services you might misuse. 🐙 Meanwhile, real developers roll their eyes and go back to actually writing code! 🙄
https://www.deployhq.com/blog/unlocking-seamless-development-and-collaboration-a-deep-dive-into-openapi #DeveloperHumor #CodingStruggles #HackerNews #ngated

A Deep Dive into OpenAPI

https://www.deployhq.com/blog/unlocking-seamless-development-and-collaboration-a-deep-dive-into-openapi

#HackerNews #OpenAPI #Development #API #Documentation #Software #Engineering #Collaboration

Anyone have a preferred tool for viewing/editing #OpenAPI specs? Ideally a client vs a web renderer, and bonus points if it runs on Linux. Thanks....

To make it easier to get started with overlays in #OpenAPI and #AsyncAPI, the maintainers of OpenAPI Format have created a web interface for working through a visual UI. And @Philsturgeon has even put together a practical guide to help you dive in!

https://docs.bump.sh/guides/openapi/openapi-format-overlays/?utm_source=mastodon&utm_medium=social&utm_campaign=openapi_format_guide&utm_content=bump

The #mastodon #openapi parser now includes example response payloads, error types, and rate limiting headers.

https://abraham.github.io/mastodon-openapi/

CouchDB also seems to be a technically simple solution—although it seems more difficult to use. And it's built with erlang!

1. Automatically generating OpenAPI documentation for your web resources doesn't seem doable, but there's perhaps CouchDB's own form of API documentation.
2. HTTP OPTIONS requests are accepted although poorly documented from what I could find.

It'd be nice if CouchDB supported learning about it's API through OpenAPI documentation.

#CouchDB #HTTP #REST #OpenAPI #erlang

Implementing this in as technically simple a manner as is possible can be done using postgREST, on top of postgres and nginx.

1. OpenAPI: https://docs.postgrest.org/en/v12/references/api/openapi.html
2. HTTP OPTIONS: https://docs.postgrest.org/en/v12/references/api/options.html

#postgres #postgREST #HTTP #REST #OpenAPI

Ready to streamline your API workflow? 🚀

Our latest blog post dives into how OpenAPI fosters seamless development and collaboration, helping you build better APIs, faster.

Read the deep dive: https://www.deployhq.com/blog/unlocking-seamless-development-and-collaboration-a-deep-dive-into-openapi

#OpenAPI #API #DevOps #Development

#ASPNETCore updates in .NET 10 Preview 5 | by Dan Roth. buff.ly/BUjREUw #dotnet #dotnet10 #webdev #blazor #openapi

ASP.NET Core updates in .NET 1...

#ASPNETCore updates in .NET 10 Preview 5 | by Dan Roth.

https://github.com/dotnet/aspnetcore/discussions/62300

#dotnet #dotnet10 #webdev #blazor #openapi

The #openapi spec parsed from the #mastodon docs is now being published to #github pages.

https://abraham.github.io/mastodon-openapi/

I've got a version of @meow running on a generated #dart client mostly working.

Hey folks, what's your favorite code generator when doing spec-first development with #OpenAPI?

Ideally it would generate sources for #Golang, #TypeScript, and #Java, but individual code generators for these ecosystems would also be okay.

Bonus points if it generates idiomatic and extensible code in the respective programming language.

#SpecDrivenDevelopment #APIDrivenDevelopment

Even though I barely got my hands dirty with #golang I really enjoy working with #fiber and #entgo for #REST APIs so far.

Would be nice to autogenerate entities/endpoints via #OpenAPI definition so I end up having Ent schema structs and Fiber endpoints 🤔

#dev #webdev

OpenAPI Meets Qwen: AI-Powered API Docs with Quarkus, LangChain4j & Ollama
Build dynamic APIs in dev and let Qwen do the documentation for you.
https://myfear.substack.com/p/quarkus-openapi-ai-docs-langchain4j
#Java #Quarkus #Langchain4j #OpenAPI #Qwen #Documentation

via @dotnet : .NET 10 Preview 5 is now available!

https://ift.tt/8hIvZgN
#DotNET10 #Preview5 #CSharp #ASPNetCore #Blazor #DotNETMAUI #FSharp #WPF #WindowsForms #EntityFrameworkCore #PostQuantumCryptography #OpenAPI #VisualStudio #DeveloperCommunity #GitHubDiscus…

Minimal API: Избавляемся от устаревающих контроллеров в ASP.NET Core

Я, думаю, многие уже слышали о появившихся в .NET 6 Minimal API - легковесной замене контроллеров/MVC. Кто-то уже успел ознакомиться и задался вопросом: "Ваше API в 3 строчки, это, конечно, здорово, но как это будет работать в реальном проекте с сотнями эндпоинтов, кучей фильтров, аттрибутов, расширениями OpenAPI/Swagger и прочих радостях?" В этой статье я хочу ответить на этот вопрос: пройдемся от основ, преимуществ, недостатков, и закончим нюансами работы и проблемами, которые обязательно возникнут при миграции с контроллеров на Minimal API в крупном проекте. А забегая чуть вперед: если думаете, стоит ли переводить проект на Mini API, вот вам сразу полезная информация: они могут жить в проекте вместе, причем даже без дублирования инфраструктуры: не обязательно переводить все разом - подробнее под катом. Бонусом, заменим SwaggerGen на реализацию OpenAPI от Microsoft.

https://habr.com/ru/articles/917378/

#c# #net #minimal_api #mvc #api #software_design #openapi #swagger