#OpenAPI

Florin HaslerIf you are a journalist, political scientist, developer or someone interested in <a href="https://mastodon.social/tags/data" class="mention hashtag" rel="nofollow noopener" target="_blank">#data</a> on 🇨🇭 political affairs, parliamentary proceedings, political actors, decrees, etc., please test our <a href="https://mastodon.social/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> and give us feedback on your observations, any issues or missing options! ❤️<a href="https://opendata.ch/news/test-our-open-parl-data-api/" rel="nofollow noopener" translate="no" target="_blank">https://opendata.ch/news/test-our-open-parl-data-api/</a>

KeevWe can find out who a celebrity is dating in seconds. But parking spaces, local beach and fire alerts, or local community activities? Almost impossible.We need more public data through open APIs.<a href="https://sunny.garden/tags/OpenData" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenData</a> <a href="https://sunny.garden/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> <a href="https://sunny.garden/tags/PublicData" class="mention hashtag" rel="nofollow noopener" target="_blank">#PublicData</a> <a href="https://sunny.garden/tags/SmartCities" class="mention hashtag" rel="nofollow noopener" target="_blank">#SmartCities</a> <a href="https://sunny.garden/tags/DataForGood" class="mention hashtag" rel="nofollow noopener" target="_blank">#DataForGood</a>

Peter HanecakK <a href="https://mastodon.social/tags/eFakt%C3%BAra" class="mention hashtag" rel="nofollow noopener" target="_blank">#eFaktúra</a> vramci <a href="https://mastodon.social/tags/NikSaNep%C3%BDtaAJaOdpoved%C3%A1m" class="mention hashtag" rel="nofollow noopener" target="_blank">#NikSaNepýtaAJaOdpovedám</a>:1. technicky: Chcem <a href="https://mastodon.social/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> priamo od statu zadarmo. Nechcem platit vypalne nejakej zabe na prameni za to, ze vystavujem fakturu. 2. vseobecne: Ked budem vidiet, ze v base za danove a ine podvody sedia ludia typu Bastrnak, Kocner, atd. a pod. rutinne, a nie "omylom", tak taketo opatrenia budem vitat. V systeme "nasich ludi" (a.k.a. <a href="https://mastodon.social/tags/SmerHlasMafia" class="mention hashtag" rel="nofollow noopener" target="_blank">#SmerHlasMafia</a>) to vsak vnimam pre slusnych ludi ako zbytocne a nebezpecne.ref.: <a href="https://platforma.slovensko.digital/t/e-fakturacia-v-sr/9628" rel="nofollow noopener" translate="no" target="_blank">https://platforma.slovensko.digital/t/e-fakturacia-v-sr/9628</a><a href="https://mastodon.social/tags/eGov" class="mention hashtag" rel="nofollow noopener" target="_blank">#eGov</a>

Chris Hartgerink (they/them)anybody have favorite <a href="https://akademienl.social/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> website generators they want to share? I'm looking for options and happy to consider what gets you excited 😄

Café-Junkie<a href="https://social.bund.de/@bsi" class="u-url mention" rel="nofollow noopener" target="_blank">@bsi</a> LOL 🤣🤣🤣🤣🤣🤣 Liebes BSI, schafft doch einfach Vorgaben und Standards bzw. initiiert entsprechende Gesetze, dass Geräte nicht per Default "nach Hause telefonieren" und "Telemetrie senden"! Unterstützt Open-Source ÜBERALL, vor allem in der Verwaltung! Sorgt dafür, dass europäische Unternehmen mit Achtung der DSGVO Vorrang haben bei Vergaben! 🧐 DAS IST DOCH EURE AUFGABE!!! 🧐 <a href="https://troet.cafe/tags/OpenSource" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenSource</a> <a href="https://troet.cafe/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> <a href="https://troet.cafe/tags/dezentraleInfrastruktur" class="mention hashtag" rel="nofollow noopener" target="_blank">#dezentraleInfrastruktur</a> <a href="https://troet.cafe/tags/MadeInEurope" class="mention hashtag" rel="nofollow noopener" target="_blank">#MadeInEurope</a>

Miguel Afonso Caetano“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.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.”<a href="https://robertdelwood.medium.com/starting-api-documentation-writers-obstacles-to-watch-out-for-e0907610466f" rel="nofollow noopener" translate="no" target="_blank">https://robertdelwood.medium.com/starting-api-documentation-writers-obstacles-to-watch-out-for-e0907610466f</a><a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener" target="_blank">#TechnicalWriting</a> <a href="https://tldr.nettime.org/tags/APIDocumentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#APIDocumentation</a> <a href="https://tldr.nettime.org/tags/APIs" class="mention hashtag" rel="nofollow noopener" target="_blank">#APIs</a> <a href="https://tldr.nettime.org/tags/Programming" class="mention hashtag" rel="nofollow noopener" target="_blank">#Programming</a> <a href="https://tldr.nettime.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> <a href="https://tldr.nettime.org/tags/DocsAsCode" class="mention hashtag" rel="nofollow noopener" target="_blank">#DocsAsCode</a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener" target="_blank">#SoftwareDevelopment</a> <a href="https://tldr.nettime.org/tags/Postman" class="mention hashtag" rel="nofollow noopener" target="_blank">#Postman</a>

Miguel Afonso Caetano"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.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).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."<a href="https://thenewstack.io/how-to-prepare-your-api-for-ai-agents/" rel="nofollow noopener" translate="no" target="_blank">https://thenewstack.io/how-to-prepare-your-api-for-ai-agents/</a><a href="https://tldr.nettime.org/tags/AI" class="mention hashtag" rel="nofollow noopener" target="_blank">#AI</a> <a href="https://tldr.nettime.org/tags/GenerativeAI" class="mention hashtag" rel="nofollow noopener" target="_blank">#GenerativeAI</a> <a href="https://tldr.nettime.org/tags/AIAgents" class="mention hashtag" rel="nofollow noopener" target="_blank">#AIAgents</a> <a href="https://tldr.nettime.org/tags/AgenticAI" class="mention hashtag" rel="nofollow noopener" target="_blank">#AgenticAI</a> <a href="https://tldr.nettime.org/tags/LLMs" class="mention hashtag" rel="nofollow noopener" target="_blank">#LLMs</a> <a href="https://tldr.nettime.org/tags/API" class="mention hashtag" rel="nofollow noopener" target="_blank">#API</a> <a href="https://tldr.nettime.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> <a href="https://tldr.nettime.org/tags/RAGs" class="mention hashtag" rel="nofollow noopener" target="_blank">#RAGs</a> <a href="https://tldr.nettime.org/tags/MCP" class="mention hashtag" rel="nofollow noopener" target="_blank">#MCP</a>

Bump.shSpringDoc is a really cool tool that lets you generate <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> 3.1 specification files from any <a href="https://fosstodon.org/tags/Spring" class="mention hashtag" rel="nofollow noopener" target="_blank">#Spring</a> app, all you need to do is add annotations. To help you get started, <a href="https://mastodon.green/@Philsturgeon" class="u-url mention" rel="nofollow noopener" target="_blank">@Philsturgeon</a> has put together this excellent guide:<a href="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" rel="nofollow noopener" translate="no" target="_blank">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>

Bump.shTo make it easier to get started with overlays in <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> and <a href="https://fosstodon.org/tags/AsyncAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#AsyncAPI</a>, the maintainers of OpenAPI Format have created a web interface for working through a visual UI. And <a href="https://mastodon.green/@Philsturgeon" class="u-url mention" rel="nofollow noopener" target="_blank">@Philsturgeon</a> has even put together a practical guide to help you dive in!<a href="https://docs.bump.sh/guides/openapi/openapi-format-overlays/?utm_source=mastodon&utm_medium=social&utm_campaign=openapi_format_guide&utm_content=bump" rel="nofollow noopener" translate="no" target="_blank">https://docs.bump.sh/guides/openapi/openapi-format-overlays/?utm_source=mastodon&utm_medium=social&utm_campaign=openapi_format_guide&utm_content=bump</a>

Abraham WilliamsThe <a href="https://indieweb.social/tags/openapi" class="mention hashtag" rel="nofollow noopener" target="_blank">#openapi</a> spec parsed from the <a href="https://indieweb.social/tags/mastodon" class="mention hashtag" rel="nofollow noopener" target="_blank">#mastodon</a> docs is now being published to <a href="https://indieweb.social/tags/github" class="mention hashtag" rel="nofollow noopener" target="_blank">#github</a> pages. <a href="https://abraham.github.io/mastodon-openapi/" rel="nofollow noopener" translate="no" target="_blank">https://abraham.github.io/mastodon-openapi/</a>I've got a version of <a href="https://abraham.social/@meow" class="u-url mention" rel="nofollow noopener" target="_blank">@meow</a> running on a generated <a href="https://indieweb.social/tags/dart" class="mention hashtag" rel="nofollow noopener" target="_blank">#dart</a> client mostly working.

Markus EiseleOpenAPI Meets Qwen: AI-Powered API Docs with Quarkus, LangChain4j & Ollama Build dynamic APIs in dev and let Qwen do the documentation for you. <a href="https://myfear.substack.com/p/quarkus-openapi-ai-docs-langchain4j" rel="nofollow noopener" translate="no" target="_blank">https://myfear.substack.com/p/quarkus-openapi-ai-docs-langchain4j</a> <a href="https://mastodon.online/tags/Java" class="mention hashtag" rel="nofollow noopener" target="_blank">#Java</a> <a href="https://mastodon.online/tags/Quarkus" class="mention hashtag" rel="nofollow noopener" target="_blank">#Quarkus</a> <a href="https://mastodon.online/tags/Langchain4j" class="mention hashtag" rel="nofollow noopener" target="_blank">#Langchain4j</a> <a href="https://mastodon.online/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> <a href="https://mastodon.online/tags/Qwen" class="mention hashtag" rel="nofollow noopener" target="_blank">#Qwen</a> <a href="https://mastodon.online/tags/Documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#Documentation</a>

Abraham WilliamsAttempting to parse the <a href="https://indieweb.social/tags/mastodon" class="mention hashtag" rel="nofollow noopener" target="_blank">#mastodon</a> <a href="https://indieweb.social/tags/api" class="mention hashtag" rel="nofollow noopener" target="_blank">#api</a> docs into an <a href="https://indieweb.social/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> spec to use for generating an API client.<a href="https://github.com/abraham/mastodon-openapi" rel="nofollow noopener" translate="no" target="_blank">https://github.com/abraham/mastodon-openapi</a>

just small circles 🕊<a href="https://mastodon.social/@maxd" class="u-url mention" rel="nofollow noopener" target="_blank">@maxd</a> <a href="https://hollo.social/@hongminhee" class="u-url mention" rel="nofollow noopener" target="_blank">@hongminhee</a> What may be interesting is <a href="https://social.coop/tags/AsyncAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#AsyncAPI</a> which is like <a href="https://social.coop/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> but then oriented towards event-driven architectures. More appropriate for message passing protocols like <a href="https://social.coop/tags/ActivityPub" class="mention hashtag" rel="nofollow noopener" target="_blank">#ActivityPub</a>. <a href="https://www.asyncapi.com/en" rel="nofollow noopener" translate="no" target="_blank">https://www.asyncapi.com/en</a>

partizanWhat would you use, when you need to generate API client based on OpenAPI Spec?I've been using openapi-generator-cli for generating typescript APIs, and it's sort of okay, but I cannot say I'm completely happy with it.Looking at <a href="https://openapi.tools/" rel="nofollow noopener" translate="no" target="_blank">https://openapi.tools/</a> I found <a href="https://www.stainless.com/" rel="nofollow noopener" translate="no" target="_blank">https://www.stainless.com/</a> and apparently OpenAI is using this to generate their API client. Which is pretty good indicator.Any recommendations?<a href="https://twiukraine.com/tags/python" class="mention hashtag" rel="nofollow noopener" target="_blank">#python</a> <a href="https://twiukraine.com/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a>

Greg Harvey 🌍Hey <a href="https://tooting.ch/tags/fediverse" class="mention hashtag" rel="nofollow noopener" target="_blank">#fediverse</a>, does anyone know which hosting companies are still implementing <a href="https://tooting.ch/tags/Apache" class="mention hashtag" rel="nofollow noopener" target="_blank">#Apache</a> <a href="https://tooting.ch/tags/CloudStack" class="mention hashtag" rel="nofollow noopener" target="_blank">#CloudStack</a> and/or <a href="https://tooting.ch/tags/libcloud" class="mention hashtag" rel="nofollow noopener" target="_blank">#libcloud</a>? I thought <a href="https://tooting.ch/tags/Exoscale" class="mention hashtag" rel="nofollow noopener" target="_blank">#Exoscale</a> were, but it seems they have moved to a custom <a href="https://tooting.ch/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> based thing they made themselves. It's pretty good, but I was hoping to implement a standard... Wondering if it's worth exploring CloudStack further or it's a dead duck...? 🤔

happyborgI've been lax at updates to the dweb REST API which now supports most <a href="https://fosstodon.org/tags/Autonomi" class="mention hashtag" rel="nofollow noopener" target="_blank">#Autonomi</a> data types.Web apps can POST/GET immutable data such as files and Archives (public and private), do multipart uploads of file(s), POST/PUT/GET Pointers (mutable references to other types) and POST/PUT/GET Scratchpads which are mutable storage for encrypted or public data.To view <a href="https://fosstodon.org/tags/dweb" class="mention hashtag" rel="nofollow noopener" target="_blank">#dweb</a> <a href="https://fosstodon.org/tags/REST" class="mention hashtag" rel="nofollow noopener" target="_blank">#REST</a> APIs: - get rust - cargo install dweb-cli - dweb serve In another terminal: - dweb openapi-docs<a href="https://fosstodon.org/tags/p2p" class="mention hashtag" rel="nofollow noopener" target="_blank">#p2p</a> <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> <a href="https://fosstodon.org/tags/FOSS" class="mention hashtag" rel="nofollow noopener" target="_blank">#FOSS</a>

Markus EiseleImplementing Zalando RESTful API Guidelines with Quarkus <a href="https://myfear.substack.com/p/implementing-zalando-restful-api" rel="nofollow noopener" translate="no" target="_blank">https://myfear.substack.com/p/implementing-zalando-restful-api</a> <a href="https://mastodon.online/tags/Java" class="mention hashtag" rel="nofollow noopener" target="_blank">#Java</a> <a href="https://mastodon.online/tags/Quarkus" class="mention hashtag" rel="nofollow noopener" target="_blank">#Quarkus</a> <a href="https://mastodon.online/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> <a href="https://mastodon.online/tags/Zalando" class="mention hashtag" rel="nofollow noopener" target="_blank">#Zalando</a>

Gloria Ciavarrini :redhat:🚀 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: <a href="https://devfest.gdgpisa.it/talk/overlay-and-arazzo-from-api-definitions-to-api-experiences/" rel="nofollow noopener" translate="no" target="_blank">https://devfest.gdgpisa.it/talk/overlay-and-arazzo-from-api-definitions-to-api-experiences/</a>Hope to see you there! 🎉<a href="https://fosstodon.org/tags/DevFestPisa" class="mention hashtag" rel="nofollow noopener" target="_blank">#DevFestPisa</a> <a href="https://fosstodon.org/tags/TechTalks" class="mention hashtag" rel="nofollow noopener" target="_blank">#TechTalks</a> <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> <a href="https://fosstodon.org/tags/Networking" class="mention hashtag" rel="nofollow noopener" target="_blank">#Networking</a> <a href="https://fosstodon.org/tags/Overlay" class="mention hashtag" rel="nofollow noopener" target="_blank">#Overlay</a> <a href="https://fosstodon.org/tags/Arazzo" class="mention hashtag" rel="nofollow noopener" target="_blank">#Arazzo</a> <a href="https://fosstodon.org/tags/OpenSource" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenSource</a> <a href="https://fosstodon.org/tags/Tech" class="mention hashtag" rel="nofollow noopener" target="_blank">#Tech</a>

Markus EiseleSpec-First or Code-First? Choosing Your OpenAPI Strategy with Quarkus vs. Spring <a href="https://myfear.substack.com/p/spec-first-or-code-first-choosing" rel="nofollow noopener" translate="no" target="_blank">https://myfear.substack.com/p/spec-first-or-code-first-choosing</a> <a href="https://mastodon.online/tags/Java" class="mention hashtag" rel="nofollow noopener" target="_blank">#Java</a> <a href="https://mastodon.online/tags/Quarkus" class="mention hashtag" rel="nofollow noopener" target="_blank">#Quarkus</a> <a href="https://mastodon.online/tags/APIDesign" class="mention hashtag" rel="nofollow noopener" target="_blank">#APIDesign</a> <a href="https://mastodon.online/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a>

happyborgGood progress on the <a href="https://fosstodon.org/tags/dweb" class="mention hashtag" rel="nofollow noopener" target="_blank">#dweb</a> REST APIs and improvements to the <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenAPI</a> docs today, all with the help of <a href="https://fosstodon.org/tags/actix" class="mention hashtag" rel="nofollow noopener" target="_blank">#actix</a> and <a href="https://fosstodon.org/tags/utoipa" class="mention hashtag" rel="nofollow noopener" target="_blank">#utoipa</a> BTW <a href="https://fosstodon.org/tags/SwaggerUI" class="mention hashtag" rel="nofollow noopener" target="_blank">#SwaggerUI</a> 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 <a href="https://fosstodon.org/tags/GraphQL" class="mention hashtag" rel="nofollow noopener" target="_blank">#GraphQL</a> but I haven't looked into that. Convince me that I should!

Recent searches

Search options

Administered by:

Server stats: