mastodon.ie is one of the many independent Mastodon servers you can use to participate in the fediverse.
Irish Mastodon - run from Ireland, we welcome all who respect the community rules and members.

Administered by:

Server stats:

1.6K
active users

#openapi

1 post1 participant0 posts today
Chris Hartgerink (they/them)<p>anybody have favorite <a href="https://akademienl.social/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a> website generators they want to share? I'm looking for options and happy to consider what gets you excited 😄</p>
João Antunes<p>New one up 🗞️</p><p>"Adopting Problem Details for HTTP APIs"</p><p>In which I rant a bit, but also provide a glimpse about how we're looking into it at work.</p><p><a href="https://mastodon.social/tags/OpenApi" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenApi</span></a> <a href="https://mastodon.social/tags/HttpApi" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>HttpApi</span></a> <a href="https://mastodon.social/tags/ProblemDetails" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>ProblemDetails</span></a> <a href="https://mastodon.social/tags/DotNet" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>DotNet</span></a> <a href="https://mastodon.social/tags/CSharp" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>CSharp</span></a></p><p><a href="https://blog.codingmilitia.com/2025/07/15/adopting-problem-details-for-http-apis/" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">blog.codingmilitia.com/2025/07</span><span class="invisible">/15/adopting-problem-details-for-http-apis/</span></a></p>
Jamie Tanna<p><strong>I'm on Fallthrough: Why You're Wrong About REST</strong></p> Announcing my appearance as a guest co-host on Fallthrough, talking about REST, Hypermedia, and more. <p><a href="https://fed.brid.gy/r/https://www.jvt.me/posts/2025/07/14/fallthrough-hypermedia/" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">fed.brid.gy/r/https://www.jvt.</span><span class="invisible">me/posts/2025/07/14/fallthrough-hypermedia/</span></a></p>
Vincent Biret<p>Introducing: BinkyLabs.OpenApi.Overlay a new library to parse and apply OpenAPI overlays in <a href="https://hachyderm.io/tags/dotnet" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>dotnet</span></a> !!! 🎉🎉🎉🎉</p><p><a href="https://github.com/BinkyLabs/openapi-overlays-dotnet" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/BinkyLabs/openapi-o</span><span class="invisible">verlays-dotnet</span></a></p><p>Over the last week, a good friend of mine Matthieu COSTABELLO and I have been hacking away to produce this new library. It's modeled after Microsoft.OpenAPI, parses, serializes and applies overlays to documents.</p><p>With overlays, you can maintain patches to <a href="https://hachyderm.io/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a> description, extremely useful when your team doesn't "own" the document but needs to maintain only a few changes. Using this library, a host of OpenAPI tools built in <a href="https://hachyderm.io/tags/dotnet" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>dotnet</span></a> will be able to support this specification and new feature!</p><p>Stay tuned for more projects from BinkyLabs!</p><p><a href="https://hachyderm.io/tags/API" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>API</span></a> <a href="https://hachyderm.io/tags/REST" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>REST</span></a> <a href="https://hachyderm.io/tags/OSS" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OSS</span></a></p>
Café-Junkie<p><span class="h-card" translate="no"><a href="https://social.bund.de/@bsi" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>bsi</span></a></span> <br>LOL<br>🤣🤣🤣🤣🤣🤣<br>Liebes BSI,<br>schafft doch einfach Vorgaben und Standards bzw. initiiert entsprechende Gesetze, dass Geräte nicht per Default "nach Hause telefonieren" und "Telemetrie senden"!<br>Unterstützt Open-Source ÜBERALL, vor allem in der Verwaltung!<br>Sorgt dafür, dass europäische Unternehmen mit Achtung der DSGVO Vorrang haben bei Vergaben!<br>🧐 <br>DAS IST DOCH EURE AUFGABE!!!<br>🧐 <br><a href="https://troet.cafe/tags/OpenSource" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenSource</span></a><br><a href="https://troet.cafe/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a> <br><a href="https://troet.cafe/tags/dezentraleInfrastruktur" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>dezentraleInfrastruktur</span></a> <br><a href="https://troet.cafe/tags/MadeInEurope" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MadeInEurope</span></a></p>
Vincent Biret<p><a href="https://hachyderm.io/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a> Initiative Newsletter – June 2025 <a href="https://www.openapis.org/blog/2025/06/25/openapi-initiative-newsletter-june-2025" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://www.</span><span class="ellipsis">openapis.org/blog/2025/06/25/o</span><span class="invisible">penapi-initiative-newsletter-june-2025</span></a></p>
Miguel Afonso Caetano<p>“The goal from starting out is to be able to create an API documentation suite from scratch. The minimal viable document, or the minimum the document must contain before it’s released, includes having all the calls covered, a description, even if only one sentence at this point, for every field and call, section overviews, call examples, and examples of each field. I suggest also creating a Postman collection file for each API suite. A Postman collection file is a complete set of all the requests and that each request may be run by clicking it; it’s a convenience to clients.</p><p>Being able to create that document indicates the writer’s proficiency in the mechanics of API documentation. There is a sense of accomplishment when achieving this and comfort with this process. And rightly so. They have the privilege now of calling themselves API documentation writers.”</p><p><a href="https://robertdelwood.medium.com/starting-api-documentation-writers-obstacles-to-watch-out-for-e0907610466f" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">robertdelwood.medium.com/start</span><span class="invisible">ing-api-documentation-writers-obstacles-to-watch-out-for-e0907610466f</span></a></p><p><a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>TechnicalWriting</span></a> <a href="https://tldr.nettime.org/tags/APIDocumentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>APIDocumentation</span></a> <a href="https://tldr.nettime.org/tags/APIs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>APIs</span></a> <a href="https://tldr.nettime.org/tags/Programming" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Programming</span></a> <a href="https://tldr.nettime.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a> <a href="https://tldr.nettime.org/tags/DocsAsCode" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>DocsAsCode</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>SoftwareDevelopment</span></a> <a href="https://tldr.nettime.org/tags/Postman" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Postman</span></a></p>
Miguel Afonso Caetano<p>"Without clear signposting, an agent might miss your API entirely. If it does discover it, large language models (LLMs) may stumble with undocumented behaviors, hallucinate methods or flood your servers with random calls.</p><p>So, it’s important to get it right. Thankfully, strategies are emerging to position APIs for AI agents, from new standards to underground tricks. And, it’s more than just “get an MCP server” (though that’s a crucial step).</p><p>The jury’s out on what strategy will be most effective. So I’ve structured this guide to start with broadly agreed-upon best practices, then explore ones still taking shape. Most tips apply equally to public, partner and private APIs."</p><p><a href="https://thenewstack.io/how-to-prepare-your-api-for-ai-agents/" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">thenewstack.io/how-to-prepare-</span><span class="invisible">your-api-for-ai-agents/</span></a></p><p><a href="https://tldr.nettime.org/tags/AI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>AI</span></a> <a href="https://tldr.nettime.org/tags/GenerativeAI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>GenerativeAI</span></a> <a href="https://tldr.nettime.org/tags/AIAgents" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>AIAgents</span></a> <a href="https://tldr.nettime.org/tags/AgenticAI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>AgenticAI</span></a> <a href="https://tldr.nettime.org/tags/LLMs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>LLMs</span></a> <a href="https://tldr.nettime.org/tags/API" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>API</span></a> <a href="https://tldr.nettime.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a> <a href="https://tldr.nettime.org/tags/RAGs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>RAGs</span></a> <a href="https://tldr.nettime.org/tags/MCP" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MCP</span></a></p>
Bump.sh<p>SpringDoc is a really cool tool that lets you generate <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a> 3.1 specification files from any <a href="https://fosstodon.org/tags/Spring" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Spring</span></a> app, all you need to do is add annotations. To help you get started, <span class="h-card" translate="no"><a href="https://mastodon.green/@Philsturgeon" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>Philsturgeon</span></a></span> has put together this excellent guide:</p><p><a href="https://bump.sh/blog/generating-openapi-docs-for-java-with-spring-boot/?utm_source=mastodon&amp;utm_medium=social&amp;utm_campaign=spring_boot_guide&amp;utm_content=bump" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">bump.sh/blog/generating-openap</span><span class="invisible">i-docs-for-java-with-spring-boot/?utm_source=mastodon&amp;utm_medium=social&amp;utm_campaign=spring_boot_guide&amp;utm_content=bump</span></a></p>
Abraham Williams<p>Finally got <span class="h-card" translate="no"><a href="https://abraham.social/@meow" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>meow</span></a></span> running on a <a href="https://indieweb.social/tags/mastodon" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>mastodon</span></a> API client generated from an <a href="https://indieweb.social/tags/openapi" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>openapi</span></a> spec.</p>
Dave Wood 🇨🇦<p>Anyone have a preferred tool for viewing/editing <a href="https://mastodon.social/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a> specs? Ideally a client vs a web renderer, and bonus points if it runs on Linux. Thanks....</p>
Bump.sh<p>To make it easier to get started with overlays in <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a> and <a href="https://fosstodon.org/tags/AsyncAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>AsyncAPI</span></a>, the maintainers of OpenAPI Format have created a web interface for working through a visual UI. And <span class="h-card" translate="no"><a href="https://mastodon.green/@Philsturgeon" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>Philsturgeon</span></a></span> has even put together a practical guide to help you dive in!</p><p><a href="https://docs.bump.sh/guides/openapi/openapi-format-overlays/?utm_source=mastodon&amp;utm_medium=social&amp;utm_campaign=openapi_format_guide&amp;utm_content=bump" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">docs.bump.sh/guides/openapi/op</span><span class="invisible">enapi-format-overlays/?utm_source=mastodon&amp;utm_medium=social&amp;utm_campaign=openapi_format_guide&amp;utm_content=bump</span></a></p>
Abraham Williams<p>The <a href="https://indieweb.social/tags/mastodon" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>mastodon</span></a> <a href="https://indieweb.social/tags/openapi" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>openapi</span></a> parser now includes example response payloads, error types, and rate limiting headers.</p><p><a href="https://abraham.github.io/mastodon-openapi/" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">abraham.github.io/mastodon-ope</span><span class="invisible">napi/</span></a></p>
Richard Freeman<p>CouchDB also seems to be a technically simple solution—although it seems more difficult to use. And it's built with erlang!</p><p>1. Automatically generating OpenAPI documentation for your web resources doesn't seem doable, but there's perhaps CouchDB's own form of API documentation.<br>2. HTTP OPTIONS requests are accepted although poorly documented from what I could find.</p><p>It'd be nice if CouchDB supported learning about it's API through OpenAPI documentation.</p><p><a href="https://tacobelllabs.net/tags/CouchDB" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>CouchDB</span></a> <a href="https://tacobelllabs.net/tags/HTTP" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>HTTP</span></a> <a href="https://tacobelllabs.net/tags/REST" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>REST</span></a> <a href="https://tacobelllabs.net/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a></p>
Richard Freeman<p>Implementing this in as technically simple a manner as is possible can be done using postgREST, on top of postgres and nginx.</p><p>1. OpenAPI: <a href="https://docs.postgrest.org/en/v12/references/api/openapi.html" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">docs.postgrest.org/en/v12/refe</span><span class="invisible">rences/api/openapi.html</span></a><br>2. HTTP OPTIONS: <a href="https://docs.postgrest.org/en/v12/references/api/options.html" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">docs.postgrest.org/en/v12/refe</span><span class="invisible">rences/api/options.html</span></a></p><p><a href="https://tacobelllabs.net/tags/postgres" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>postgres</span></a> <a href="https://tacobelllabs.net/tags/postgREST" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>postgREST</span></a> <a href="https://tacobelllabs.net/tags/HTTP" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>HTTP</span></a> <a href="https://tacobelllabs.net/tags/REST" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>REST</span></a> <a href="https://tacobelllabs.net/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a></p>
Alvin Ashcraft<p><a class="hashtag" rel="nofollow noopener" href="https://bsky.app/search?q=%23ASPNETCore" target="_blank">#ASPNETCore</a> updates in .NET 10 Preview 5 | by Dan Roth. <a href="https://buff.ly/BUjREUw" rel="nofollow noopener" target="_blank">buff.ly/BUjREUw</a> <a class="hashtag" rel="nofollow noopener" href="https://bsky.app/search?q=%23dotnet" target="_blank">#dotnet</a> <a class="hashtag" rel="nofollow noopener" href="https://bsky.app/search?q=%23dotnet10" target="_blank">#dotnet10</a> <a class="hashtag" rel="nofollow noopener" href="https://bsky.app/search?q=%23webdev" target="_blank">#webdev</a> <a class="hashtag" rel="nofollow noopener" href="https://bsky.app/search?q=%23blazor" target="_blank">#blazor</a> <a class="hashtag" rel="nofollow noopener" href="https://bsky.app/search?q=%23openapi" target="_blank">#openapi</a><br><br><a href="https://buff.ly/BUjREUw" rel="nofollow noopener" target="_blank">ASP.NET Core updates in .NET 1...</a></p>
Alvin Ashcraft 🐿️<p><a href="https://hachyderm.io/tags/ASPNETCore" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>ASPNETCore</span></a> updates in .NET 10 Preview 5 | by Dan Roth.</p><p><a href="https://github.com/dotnet/aspnetcore/discussions/62300" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/dotnet/aspnetcore/d</span><span class="invisible">iscussions/62300</span></a></p><p><a href="https://hachyderm.io/tags/dotnet" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>dotnet</span></a> <a href="https://hachyderm.io/tags/dotnet10" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>dotnet10</span></a> <a href="https://hachyderm.io/tags/webdev" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>webdev</span></a> <a href="https://hachyderm.io/tags/blazor" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>blazor</span></a> <a href="https://hachyderm.io/tags/openapi" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>openapi</span></a></p>
Abraham Williams<p>The <a href="https://indieweb.social/tags/openapi" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>openapi</span></a> spec parsed from the <a href="https://indieweb.social/tags/mastodon" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>mastodon</span></a> docs is now being published to <a href="https://indieweb.social/tags/github" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>github</span></a> pages. </p><p><a href="https://abraham.github.io/mastodon-openapi/" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">abraham.github.io/mastodon-ope</span><span class="invisible">napi/</span></a></p><p>I've got a version of <span class="h-card" translate="no"><a href="https://abraham.social/@meow" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>meow</span></a></span> running on a generated <a href="https://indieweb.social/tags/dart" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>dart</span></a> client mostly working.</p>
joschi<p>Hey folks, what's your favorite code generator when doing spec-first development with <a href="https://hachyderm.io/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a>?</p><p>Ideally it would generate sources for <a href="https://hachyderm.io/tags/Golang" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Golang</span></a>, <a href="https://hachyderm.io/tags/TypeScript" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>TypeScript</span></a>, and <a href="https://hachyderm.io/tags/Java" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Java</span></a>, but individual code generators for these ecosystems would also be okay.</p><p>Bonus points if it generates idiomatic and extensible code in the respective programming language.</p><p><a href="https://hachyderm.io/tags/SpecDrivenDevelopment" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>SpecDrivenDevelopment</span></a> <a href="https://hachyderm.io/tags/APIDrivenDevelopment" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>APIDrivenDevelopment</span></a></p>
Andrew Graves :arch: :linux:<p>Even though I barely got my hands dirty with <a href="https://fosstodon.org/tags/golang" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>golang</span></a> I really enjoy working with <a href="https://fosstodon.org/tags/fiber" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>fiber</span></a> and <a href="https://fosstodon.org/tags/entgo" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>entgo</span></a> for <a href="https://fosstodon.org/tags/REST" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>REST</span></a> APIs so far.</p><p>Would be nice to autogenerate entities/endpoints via <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenAPI</span></a> definition so I end up having Ent schema structs and Fiber endpoints 🤔</p><p><a href="https://fosstodon.org/tags/dev" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>dev</span></a> <a href="https://fosstodon.org/tags/webdev" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>webdev</span></a></p>