E.g. something to describe data-format in a programming language agnostic way. With tool support for many popular programming languages, and ways to generate document. And easy enough to use.
#openapi is very popular but that's more focused on endpoints and operations, but lacking on data-format. And for my particular problem the data-format is more important than the operations.
Why is it the language-agnostic formats for defining data models are either
1. Grossly over-engineered for one purpose
2. Grossly over-verbose
3. Both
Where's my clean, easy syntax for defining data classes that can be generated into *simple* PHP, JS, Kotlin, etc? Where's my DTO-maker format?
I’ve been working with the folks at Jentic.com and they had a big launch today
Jentic is creating the #OpenSource platform for building workflows with #AgenticAI and #MCP... check out our new website jentic.com and join the conversation on our Discord server discord.gg/J22TNGqe #Arazzo #OpenAPI #AIagents
Implementing Zalando RESTful API Guidelines with Quarkus https://myfear.substack.com/p/implementing-zalando-restful-api
#Java #Quarkus #OpenAPI #Zalando
Join me at DevFest Pisa 2025 where I’ll be sharing insights on how to elevate API experiences! 
My talk, “Overlay and Arazzo: From API Definitions to API Experiences” will explore how we can transform APIs into seamless user experiences.
When: April 12, 2025
Time: 11:40 AM
Where: MACC - Pisa - Italy
Schedule: https://devfest.gdgpisa.it/talk/overlay-and-arazzo-from-api-definitions-to-api-experiences/
Hope to see you there! 
Spec-First or Code-First? Choosing Your OpenAPI Strategy with Quarkus vs. Spring https://myfear.substack.com/p/spec-first-or-code-first-choosing
#Java #Quarkus #APIDesign #OpenAPI
Good progress on the #dweb REST APIs and improvements to the #OpenAPI docs today, all with the help of #actix and #utoipa
BTW #SwaggerUI is really cool
A few days ago I knew nothing about these but now I have a working API that is documented and can be tested live while reading those docs.
Someone asked if I might support #GraphQL but I haven't looked into that. Convince me that I should!
"The accompanying diagram is intended to help you quickly decide how to document an API, but particularly a REST API. The first split is just to make sure you are looking for the right kind of API.
Here is some more context to help you decide on an approach and get started."
https://gist.github.com/briandominick/3ffab6be460fbde799aa34e0a42a4299
This is cool:
OpenAPI: The Complete Guide
"This guide is designed to give you a step-by-step overview of OpenAPI. Discover the reasons behind its creation, its capabilities and how to make a good OpenAPI API from scratch, from design to maintenance."
https://docs.bump.sh/guides/openapi/specification/v3.1/introduction/what-is-openapi/
And did you know, you can use openapi_first for contract tests as well? https://github.com/ahx/openapi_first?tab=readme-ov-file#contract-testing
Any feedback is very much appreciated
Today I added #OpenAPI documentation to #dweb for building #RESTful #p2p web apps using your favourite web framework, or no framework at all.
All I have to do now is add more APIs!
But tbh, that's easy. The hardest part is actually the documentation. 
So to make it more fun I'm adding the APIs need to enhance my #Fileman #Svelte demo.
So next is image preview which means adding /dweb-0/file-get
Having played a bit I'm now adding #OpenAPI docs with #Swagger UI to #Autonomi dweb using #utoipa and #utoipauto.
EDIT: switched from #utoipauto to #utoipa_actix_web
I'm neither a user nor, until now a builder of HTTP APIs so stumbling around, but these crates do a decent job of being usable even to a novice.
I really shouldn't be let loose with all this
Hey, folks! I’m looking for a Staff Software Engineer to join my team (API Core) at #Mailchimp.
Some of the things we work on: #PHP, #REST, #OpenAPI, #OAuth2, #APIGovernance, and more.
We are stewards of our public #APIs, and we collaborate with other capabilities teams to ensure APIs are developed according to our standards and processes. You would work directly with me on a daily basis.
This position is in Atlanta or New York.
https://jobs.intuit.com/job/atlanta/staff-software-engineer-api-core-team/27595/76329932512
It's my first open source release in what feels like years, but I've published a new #PHP library for parsing #openapi Arazzo specifications into plain old PHP objects. I'm hoping to use this as the starting point for future #arazzo related packages, and looking forward to seeing what others may build with it.
https://lornajane.net/posts/2025/markdown-mermaid-output-for-openapi-arazzo
Got completely carried away writing what was supposed to be a simple article on #OpenAPI linting and now I'm deep in Vacuum, Scalar, and Microcks features and it's GREAT. How's your Tuesday?
Qiita - 人気の記事 
