fosstodon.org is one of the many independent Mastodon servers you can use to participate in the fediverse.
Fosstodon is an invite only Mastodon instance that is open to those who are interested in technology; particularly free & open source software. If you wish to join, contact us for an invite.

Administered by:

Server stats:

9.9K
active users

#openapi

6 posts6 participants0 posts today
:mastodon: Mike Amundsen<p>"TypeSpec is an open source language and tooling for describing API contracts, created by Microsoft and shared with the community. "</p><p><a href="https://typespec.io" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">typespec.io</span><span class="invisible"></span></a> <a href="https://buff.ly/lvqvKaz" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">buff.ly/lvqvKaz</span><span class="invisible"></span></a></p><p><a href="https://mastodon.social/tags/typeSpec" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>typeSpec</span></a> <a href="https://mastodon.social/tags/api360" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>api360</span></a> <a href="https://mastodon.social/tags/openAPI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>openAPI</span></a></p>
happyborg<p>I&#39;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="tag">#<span>Autonomi</span></a> data types.</p><p>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.</p><p>To view <a href="https://fosstodon.org/tags/dweb" class="mention hashtag" rel="tag">#<span>dweb</span></a> <a href="https://fosstodon.org/tags/REST" class="mention hashtag" rel="tag">#<span>REST</span></a> APIs:<br />- get rust<br />- cargo install dweb-cli<br />- dweb serve<br />In another terminal:<br />- dweb openapi-docs</p><p><a href="https://fosstodon.org/tags/p2p" class="mention hashtag" rel="tag">#<span>p2p</span></a> <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="tag">#<span>OpenAPI</span></a> <a href="https://fosstodon.org/tags/FOSS" class="mention hashtag" rel="tag">#<span>FOSS</span></a></p>
Habr<p>Личный ИИ-ассистент на ваших данных. Часть 2: Веб-интерфейс, авторизация и стриминг ответов от ИИ</p><p>Продолжаем тему, которая вызывает живой интерес у многих разработчиков и энтузиастов ИИ — создание собственного ассистента на базе ChatGPT или DeepSeek с использованием личной базы знаний. В этой части статьи мы шаг за шагом превращаем консольную заготовку из первой части в полноценный веб-сервис: — реализуем авторизацию — создаём веб-чат с выбором нейросети — интегрируем всё через FastAPI — готовим к деплою Если вы хотите, чтобы ваш ИИ-ассистент выглядел и работал как настоящий сервис — поехали!</p><p><a href="https://habr.com/ru/companies/amvera/articles/902868/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">habr.com/ru/companies/amvera/a</span><span class="invisible">rticles/902868/</span></a></p><p><a href="https://zhub.link/tags/%D0%B2%D0%B5%D0%BA%D1%82%D0%BE%D1%80%D0%BD%D1%8B%D0%B5_%D0%B1%D0%B0%D0%B7%D1%8B_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>векторные_базы_данных</span></a> <a href="https://zhub.link/tags/python" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>python</span></a> <a href="https://zhub.link/tags/deepseek" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>deepseek</span></a> <a href="https://zhub.link/tags/chatgpt" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>chatgpt</span></a> <a href="https://zhub.link/tags/langchain" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>langchain</span></a> <a href="https://zhub.link/tags/openapi" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>openapi</span></a> <a href="https://zhub.link/tags/openapi_api" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>openapi_api</span></a> <a href="https://zhub.link/tags/fastapi" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>fastapi</span></a> <a href="https://zhub.link/tags/fastapi_stream" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>fastapi_stream</span></a> <a href="https://zhub.link/tags/jinja2" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>jinja2</span></a></p>
Yuna<p>🚀 New Release: API-Doc-Crafter just got sharper. Cleaner. Meaner.<br>Giving my little OpenAPI merging monster some upgrades.</p><p>It all started with a simple idea: merge OpenAPI specs from multiple repos.<br>Now? It transforms outdated Swagger specs to OpenAPI 3+, generates HTML pages with full navigation, and allows customization via config or env.</p><p>✨ SecurityRequirement deduplication - because why merge APIs if you can't also merge logic?</p><p>🧠 Custom metadata enrichment - inject your info, license, contact, and docs straight from config. No more excuses.</p><p>🔁 Better parser fallback - now tries more ways to read broken specs than your average intern in panic mode.</p><p>🎭 Variable substitution in outputs - ${variables} be gone. Use env or config, stay DRY, stay sane.</p><p>🧪 Tests expanded. HTML, JSON, YAML outputs covered like a nuclear bunker.</p><p>🧰 Powered by GraalVM, no reflection, blazing fast.<br>🐳 Native Docker builds.<br>🧼 Reflection config surgically trimmed. Less bloat. More edge.</p><p>Project: <a href="https://github.com/YunaBraska/api-doc-crafter" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/YunaBraska/api-doc-</span><span class="invisible">crafter</span></a><br>Happy crafting. And remember: if your docs aren't automated, they're probably lies.</p><p><a href="https://hachyderm.io/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenAPI</span></a> <a href="https://hachyderm.io/tags/Swagger" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Swagger</span></a> <a href="https://hachyderm.io/tags/APIdocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>APIdocumentation</span></a> <a href="https://hachyderm.io/tags/DevTools" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DevTools</span></a> <a href="https://hachyderm.io/tags/GraalVM" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GraalVM</span></a> <a href="https://hachyderm.io/tags/Java21" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Java21</span></a> <a href="https://hachyderm.io/tags/Docker" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docker</span></a> <a href="https://hachyderm.io/tags/Automation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Automation</span></a> <a href="https://hachyderm.io/tags/CleanCode" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CleanCode</span></a> <a href="https://hachyderm.io/tags/DevLife" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DevLife</span></a> <a href="https://hachyderm.io/tags/APIDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>APIDocs</span></a> <a href="https://hachyderm.io/tags/OpenSource" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenSource</span></a> <a href="https://hachyderm.io/tags/DeveloperTools" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DeveloperTools</span></a> <a href="https://hachyderm.io/tags/coding" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>coding</span></a> <a href="https://hachyderm.io/tags/programming" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>programming</span></a></p>
Habr<p>Optional vs Nullable на стыке технологий</p><p>При разработке современных приложений важнейшую роль играет качество клиент‑серверного взаимодействия. Для достижения стабильной связи между мобильными и веб приложениями и серверной частью необходимо стремиться к созданию надежного и эффективного механизма обмена данными. Это подразумевает создание устойчивого API, которое трудно сломать даже при изменениях в архитектуре сервера, а также легкость интеграции новых клиентов. Кроме того, одним из ключевых приоритетов становится повышение продуктивности команд разработчиков. Важно сократить цикл разработки новых функций и обновлений, позволив разработчикам быстро вносить изменения и выпускать обновления, ускоряя процесс итераций.</p><p><a href="https://habr.com/ru/articles/902552/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">habr.com/ru/articles/902552/</span><span class="invisible"></span></a></p><p><a href="https://zhub.link/tags/openapi" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>openapi</span></a> <a href="https://zhub.link/tags/kotlin" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>kotlin</span></a> <a href="https://zhub.link/tags/swift" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>swift</span></a> <a href="https://zhub.link/tags/typescript" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>typescript</span></a></p>
Gerbrand van Dieyen<p>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.</p><p><a href="https://fosstodon.org/tags/openapi" class="mention hashtag" rel="tag">#<span>openapi</span></a> is very popular but that&#39;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.</p>
Mère Teresa<p>Attendez encore plus intéressant, la DOCUMENTATION : <a href="https://swagger.io/docs/specification/v3_0/data-models/inheritance-and-polymorphism/#discriminator" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">swagger.io/docs/specification/</span><span class="invisible">v3_0/data-models/inheritance-and-polymorphism/#discriminator</span></a></p><p><a href="https://mastodon.tetaneutral.net/tags/openApi" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>openApi</span></a> <a href="https://mastodon.tetaneutral.net/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> <a href="https://mastodon.tetaneutral.net/tags/polymorphism" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>polymorphism</span></a></p>
Larry Garfield<p>Why is it the language-agnostic formats for defining data models are either</p><p>1. Grossly over-engineered for one purpose<br>2. Grossly over-verbose<br>3. Both</p><p>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?</p><p><a href="https://phpc.social/tags/Programming" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Programming</span></a> <a href="https://phpc.social/tags/Rant" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Rant</span></a> <a href="https://phpc.social/tags/Protobuf" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Protobuf</span></a> <a href="https://phpc.social/tags/Openapi" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Openapi</span></a> <a href="https://phpc.social/tags/jsonschema" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>jsonschema</span></a> <a href="https://phpc.social/tags/PHP" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>PHP</span></a> <a href="https://phpc.social/tags/Javascript" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Javascript</span></a></p>
Habr<p>Академия OpenAI для разработчиков: Разбор 10 лекций про API, RAG, Fine-tuning</p><p>OpenAI запустила свою Академию — десятки видеолекций. Полезно, но далеко не все. Если вы разработчик или аналитик, которому нужны технические детали и практические руководства по API, моделям и их оптимизации, смотреть всё подряд — не вариант. Я изучил доступные материалы и сделал выжимку из только технических материалов. Этот гайд проведет по 10 ключевым лекциям вышедшим на сегодня, которые помогут разобраться в Function Calling, RAG, Fine-tuning, Evals и других важных темах. Мы не будем здесь касаться лекций для новичков, материалов про Sora или использования ИИ в образовании — только хардкор, только для тех, кто строит и анализирует LLM.</p><p><a href="https://habr.com/ru/articles/900038/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">habr.com/ru/articles/900038/</span><span class="invisible"></span></a></p><p><a href="https://zhub.link/tags/%D0%BE%D0%B1%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>обучение</span></a> <a href="https://zhub.link/tags/llm" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>llm</span></a> <a href="https://zhub.link/tags/rag" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>rag</span></a> <a href="https://zhub.link/tags/openai" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>openai</span></a> <a href="https://zhub.link/tags/openapi" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>openapi</span></a> <a href="https://zhub.link/tags/chatgpt" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>chatgpt</span></a> <a href="https://zhub.link/tags/finetuning" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>finetuning</span></a> <a href="https://zhub.link/tags/distillation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>distillation</span></a></p>
NobleMajo<p>For REST 📡 API's written in Go 🚶, you should take a quick look at github.com/go-fuego/fuego. Getting an OpenAPI-Spec 📜 &amp; a SwaggerUI 🖥️ without any extra effort, is a huge win! </p><p><a href="https://mastodon.social/tags/REST" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>REST</span></a> <a href="https://mastodon.social/tags/API" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>API</span></a> <a href="https://mastodon.social/tags/GoLang" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GoLang</span></a> <a href="https://mastodon.social/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenAPI</span></a> <a href="https://mastodon.social/tags/Swagger" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Swagger</span></a> <a href="https://mastodon.social/tags/SwaggerUI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SwaggerUI</span></a> <a href="https://mastodon.social/tags/Fuego" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Fuego</span></a> <a href="https://mastodon.social/tags/GoFuego" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GoFuego</span></a> <a href="https://mastodon.social/tags/WebDevelopment" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>WebDevelopment</span></a> <a href="https://mastodon.social/tags/GoProgramming" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GoProgramming</span></a> <a href="https://mastodon.social/tags/APIManagement" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>APIManagement</span></a> <a href="https://mastodon.social/tags/ProgrammingTips" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ProgrammingTips</span></a> <a href="https://mastodon.social/tags/TechStack" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechStack</span></a> <a href="https://mastodon.social/tags/OpenSource" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenSource</span></a></p>
aspleenic<p>I’ve been working with the folks at Jentic.com and they had a big launch today </p><p>Jentic is creating the <a href="https://hachyderm.io/tags/OpenSource" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenSource</span></a> platform for building workflows with <a href="https://hachyderm.io/tags/AgenticAI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>AgenticAI</span></a> and <a href="https://hachyderm.io/tags/MCP" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MCP</span></a>... check out our new website jentic.com and join the conversation on our Discord server discord.gg/J22TNGqe <a href="https://hachyderm.io/tags/Arazzo" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Arazzo</span></a> <a href="https://hachyderm.io/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenAPI</span></a> <a href="https://hachyderm.io/tags/AIagents" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>AIagents</span></a></p>
Ian Wagner<p>The state of <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="tag">#<span>OpenAPI</span></a> </p><p>* Generators for 5 of the top 20 most popular programming languages have wild variations in features supported, and *usually* interpret common features differently.<br />* Two of the 5 language&#39;s client generators produce code which require manual modifications before it will compile or behave as intended.<br />* Automatic generation server-side is still limited.<br />* The latest *minor* update, released 5 years ago, only has *experimental* support in most tooling.</p>
Markus Eisele<p>Implementing Zalando RESTful API Guidelines with Quarkus <a href="https://myfear.substack.com/p/implementing-zalando-restful-api" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">myfear.substack.com/p/implemen</span><span class="invisible">ting-zalando-restful-api</span></a><br><a href="https://mastodon.online/tags/Java" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Java</span></a> <a href="https://mastodon.online/tags/Quarkus" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Quarkus</span></a> <a href="https://mastodon.online/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenAPI</span></a> <a href="https://mastodon.online/tags/Zalando" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Zalando</span></a></p>
Gloria Ciavarrini :redhat:<p>🚀 Join me at DevFest Pisa 2025 where I’ll be sharing insights on how to elevate API experiences! 🎤</p><p>My talk, “Overlay and Arazzo: From API Definitions to API Experiences” will explore how we can transform APIs into seamless user experiences.</p><p>📅 When: April 12, 2025<br />🕓 Time: 11:40 AM<br />📍 Where: MACC - Pisa - Italy<br />🗓️ Schedule: <a href="https://devfest.gdgpisa.it/talk/overlay-and-arazzo-from-api-definitions-to-api-experiences/" target="_blank" rel="nofollow noopener noreferrer" translate="no"><span class="invisible">https://</span><span class="ellipsis">devfest.gdgpisa.it/talk/overla</span><span class="invisible">y-and-arazzo-from-api-definitions-to-api-experiences/</span></a></p><p>Hope to see you there! 🎉</p><p><a href="https://fosstodon.org/tags/DevFestPisa" class="mention hashtag" rel="tag">#<span>DevFestPisa</span></a> <a href="https://fosstodon.org/tags/TechTalks" class="mention hashtag" rel="tag">#<span>TechTalks</span></a> <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="tag">#<span>OpenAPI</span></a> <a href="https://fosstodon.org/tags/Networking" class="mention hashtag" rel="tag">#<span>Networking</span></a> <a href="https://fosstodon.org/tags/Overlay" class="mention hashtag" rel="tag">#<span>Overlay</span></a> <a href="https://fosstodon.org/tags/Arazzo" class="mention hashtag" rel="tag">#<span>Arazzo</span></a> <a href="https://fosstodon.org/tags/OpenSource" class="mention hashtag" rel="tag">#<span>OpenSource</span></a> <a href="https://fosstodon.org/tags/Tech" class="mention hashtag" rel="tag">#<span>Tech</span></a></p>
Markus Eisele<p>Spec-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 noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">myfear.substack.com/p/spec-fir</span><span class="invisible">st-or-code-first-choosing</span></a><br><a href="https://mastodon.online/tags/Java" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Java</span></a> <a href="https://mastodon.online/tags/Quarkus" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Quarkus</span></a> <a href="https://mastodon.online/tags/APIDesign" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>APIDesign</span></a> <a href="https://mastodon.online/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenAPI</span></a></p>
happyborg<p>Good progress on the <a href="https://fosstodon.org/tags/dweb" class="mention hashtag" rel="tag">#<span>dweb</span></a> REST APIs and improvements to the <a href="https://fosstodon.org/tags/OpenAPI" class="mention hashtag" rel="tag">#<span>OpenAPI</span></a> docs today, all with the help of <a href="https://fosstodon.org/tags/actix" class="mention hashtag" rel="tag">#<span>actix</span></a> and <a href="https://fosstodon.org/tags/utoipa" class="mention hashtag" rel="tag">#<span>utoipa</span></a> </p><p>BTW <a href="https://fosstodon.org/tags/SwaggerUI" class="mention hashtag" rel="tag">#<span>SwaggerUI</span></a> is really cool </p><p>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.</p><p>Someone asked if I might support <a href="https://fosstodon.org/tags/GraphQL" class="mention hashtag" rel="tag">#<span>GraphQL</span></a> but I haven&#39;t looked into that. Convince me that I should!</p>
Miguel Afonso Caetano<p>"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.</p><p>Here is some more context to help you decide on an approach and get started."</p><p><a href="https://gist.github.com/briandominick/3ffab6be460fbde799aa34e0a42a4299" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">gist.github.com/briandominick/</span><span class="invisible">3ffab6be460fbde799aa34e0a42a4299</span></a></p><p><a href="https://tldr.nettime.org/tags/API" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>API</span></a> <a href="https://tldr.nettime.org/tags/APIs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>APIs</span></a> <a href="https://tldr.nettime.org/tags/APIDesign" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>APIDesign</span></a> <a href="https://tldr.nettime.org/tags/REST" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>REST</span></a> <a href="https://tldr.nettime.org/tags/APIDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>APIDocumentation</span></a> <a href="https://tldr.nettime.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenAPI</span></a> <a href="https://tldr.nettime.org/tags/DocsAsCode" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DocsAsCode</span></a> <a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalWriting</span></a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalCommunication</span></a></p>
openapiprocessor<p>.. the marker interface is simply</p><p>```java<br />package generated.model;</p><p>import generated.support.Generated;</p><p>@ Generated(value = &quot;openapi-processor-core&quot;, version = &quot;test&quot;)<br />public interface GetFooBarApplicationJsonResponse {<br />}<br />``` </p><p>and the interface name is created from http method, path, contentType and “Response” to create a unique name.</p><p>2/2</p><p><a href="https://fosstodon.org/tags/openapiprocessor" class="mention hashtag" rel="tag">#<span>openapiprocessor</span></a> <a href="https://fosstodon.org/tags/openapi" class="mention hashtag" rel="tag">#<span>openapi</span></a></p>
openapiprocessor<p>I have a prototype that automatically creates a marker interface for a response combination with different http status codes that return the same content type. For example: the an endpoints returns application/json on 200 &amp; 202 with different content. </p><p>the endpoint then would look like</p><p>```java<br />@ Mapping(&quot;/fooBar&quot;)<br />GetFooBarApplicationJsonResponse getFooBarApplicationJson();<br />```</p><p>instead of</p><p>```java<br />@ Mapping(&quot;/fooBar&quot;)<br />Object getFooBarApplicationJson();<br />```</p><p>1/2</p><p><a href="https://fosstodon.org/tags/openapiprocessor" class="mention hashtag" rel="tag">#<span>openapiprocessor</span></a> <a href="https://fosstodon.org/tags/openapi" class="mention hashtag" rel="tag">#<span>openapi</span></a></p>
Andreas Haller<p>This is cool:</p><p>OpenAPI: The Complete Guide</p><p>"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."</p><p><a href="https://docs.bump.sh/guides/openapi/specification/v3.1/introduction/what-is-openapi/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">docs.bump.sh/guides/openapi/sp</span><span class="invisible">ecification/v3.1/introduction/what-is-openapi/</span></a></p><p><a href="https://ruby.social/tags/openapi" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>openapi</span></a></p>