huh, was quite surprised to learn that openapi-generator (https://github.com/OpenAPITools/openapi-generator) is still on java version 11.
but on the other hand, would you really benefit from upgrading if your product is not a running service, but literally a library which generates a bunch of text files, and you want their content to be as stable as possible? is not upgrading at all the best tactic in that case?

#openapi #openapigenerator #java

GitHub - OpenAPITools/openapi-generator: OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)

OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3) - OpenAPITools/openapi-gener...

GitHub

Scalar на замену Swashbuckle в .NET 9 и как это готовить с Design API First

Рассказываю чем заменить Swashbuckle, который убрали из .Net 9, для создания страницы похожей на Swagger UI.

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

#web_api #aspnet_core #swagger #open_api #net_9 #dotnet_core #dotnet #typespec #webapi #openapi

Scalar на замену Swashbuckle в .NET 9 и как это готовить с Design API First

В .Net больше нет Swashbuckle . То есть из коробки больше нет Swagger UI чтобы тестировать свеженаписанные API. Microsoft поддерживают собственный пакет Microsoft.AspNetCore.OpenApi для генерации...

Хабр

FastOpenAPI: автодокументация OpenAPI для разных фреймворков на Python

Всем привет! Меня зовут Никита Рыженков, и я хочу поделиться опытом разработки библиотеки FastOpenAPI. Это инструмент, который приносит удобный стиль маршрутизации FastAPI и автоматическую документацию OpenAPI в целый ряд Python-фреймворков. Идея родилась из личной боли: в одном проекте приходилось поддерживать OpenAPI-документацию сразу в нескольких фреймворках, и я устал дублировать решения под каждый из них. Вдохновившись лаконичностью FastAPI, я решил создать унифицированный подход для Flask, AioHttp, Sanic, Falcon, Starlette, Quart, Tornado – назвал его FastOpenAPI​. В этой статье расскажу, какие проблемы решает FastOpenAPI, как он устроен внутри и как им пользоваться с примерами кода под каждый поддерживаемый фреймворк.

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

#python #openapi #flask #falcon #aiohttp #sanic #starlette #tornado #opensourсe #сезон_open_source

FastOpenAPI: автодокументация OpenAPI для разных фреймворков на Python

Документация GitHub PyPi Всем привет! Меня зовут Никита Рыженков, и я хочу поделиться опытом разработки библиотеки FastOpenAPI. Это инструмент, который предоставляет удобный стиль маршрутизации...

Хабр

"TypeSpec is an open source language and tooling for describing API contracts, created by Microsoft and shared with the community. "

https://typespec.io https://buff.ly/lvqvKaz

#typeSpec #api360 #openAPI

typespec.io

I've been lax at updates to the dweb REST API which now supports most #Autonomi 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 #dweb #REST APIs:
- get rust
- cargo install dweb-cli
- dweb serve
In another terminal:
- dweb openapi-docs

#p2p #OpenAPI #FOSS

Личный ИИ-ассистент на ваших данных. Часть 2: Веб-интерфейс, авторизация и стриминг ответов от ИИ

Продолжаем тему, которая вызывает живой интерес у многих разработчиков и энтузиастов ИИ — создание собственного ассистента на базе ChatGPT или DeepSeek с использованием личной базы знаний. В этой части статьи мы шаг за шагом превращаем консольную заготовку из первой части в полноценный веб-сервис: — реализуем авторизацию — создаём веб-чат с выбором нейросети — интегрируем всё через FastAPI — готовим к деплою Если вы хотите, чтобы ваш ИИ-ассистент выглядел и работал как настоящий сервис — поехали!

https://habr.com/ru/companies/amvera/articles/902868/

#векторные_базы_данных #python #deepseek #chatgpt #langchain #openapi #openapi_api #fastapi #fastapi_stream #jinja2

Личный ИИ-ассистент на ваших данных. Часть 2: Веб-интерфейс, авторизация и стриминг ответов от ИИ

Друзья, приветствую! Как вы поняли по названию этой статьи — сегодня мы продолжаем погружаться в тему разработки личного ИИ-ассистента на основе собственных данных. Краткое напоминание о первой части...

Хабр

🚀 New Release: API-Doc-Crafter just got sharper. Cleaner. Meaner.
Giving my little OpenAPI merging monster some upgrades.

It all started with a simple idea: merge OpenAPI specs from multiple repos.
Now? It transforms outdated Swagger specs to OpenAPI 3+, generates HTML pages with full navigation, and allows customization via config or env.

✨ SecurityRequirement deduplication - because why merge APIs if you can't also merge logic?

🧠 Custom metadata enrichment - inject your info, license, contact, and docs straight from config. No more excuses.

🔁 Better parser fallback - now tries more ways to read broken specs than your average intern in panic mode.

🎭 Variable substitution in outputs - ${variables} be gone. Use env or config, stay DRY, stay sane.

🧪 Tests expanded. HTML, JSON, YAML outputs covered like a nuclear bunker.

🧰 Powered by GraalVM, no reflection, blazing fast.
🐳 Native Docker builds.
🧼 Reflection config surgically trimmed. Less bloat. More edge.

Project: https://github.com/YunaBraska/api-doc-crafter
Happy crafting. And remember: if your docs aren't automated, they're probably lies.

#OpenAPI #Swagger #APIdocumentation #DevTools #GraalVM #Java21 #Docker #Automation #CleanCode #DevLife #APIDocs #OpenSource #DeveloperTools #coding #programming

GitHub - YunaBraska/api-doc-crafter: Clean, Merge, Group, Remove and generate OpenAPI documentation

Clean, Merge, Group, Remove and generate OpenAPI documentation - YunaBraska/api-doc-crafter

GitHub

Optional vs Nullable на стыке технологий

При разработке современных приложений важнейшую роль играет качество клиент‑серверного взаимодействия. Для достижения стабильной связи между мобильными и веб приложениями и серверной частью необходимо стремиться к созданию надежного и эффективного механизма обмена данными. Это подразумевает создание устойчивого API, которое трудно сломать даже при изменениях в архитектуре сервера, а также легкость интеграции новых клиентов. Кроме того, одним из ключевых приоритетов становится повышение продуктивности команд разработчиков. Важно сократить цикл разработки новых функций и обновлений, позволив разработчикам быстро вносить изменения и выпускать обновления, ускоряя процесс итераций.

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

#openapi #kotlin #swift #typescript

Optional vs Nullable на стыке технологий

При разработке современных приложений важнейшую роль играет качество клиент-серверного взаимодействия. Для достижения стабильной связи между мобильными и веб приложениями и серверной частью...

Хабр

🛠️ Custom GPTs: Your New API Prototyping Partner 🤖

Tired of reiterating the same context to AI tools for similar tasks? Custom GPTs are here to revolutionize your workflow!​

In my latest blog post, I explore:
- The five essential elements to customize a GPT effectively.
- A structured framework to build your own Custom GPT, much like crafting a PRD.
- A real-world application: creating an OpenAPI generator tailored to your needs.​

Embrace the power of AI to streamline your API development process.

Dive into the details here:
👉 https://tmaguire.net/blog/2025/04/14/leveraging-ai-to-prototype-apis.html?utm_source=Mastodon&utm_medium=social&utm_campaign=blog_promotion

#AI #CustomGPT #APIPrototyping #OpenAPI #TechInnovation

Leveraging AI to quickly prototype APIs

I use AI tools daily for everything from web searches to finding recipes to prototyping APIs. While powerful, these tools often require repeating the same context multiple times for similar tasks. This is where Custom GPTs in ChatGPT excel. These specialized AI assistants are trained on custom instructions and knowledge for specific tasks. Their purpose is to create focused, task-specific versions of ChatGPT that include:

Tim Maguire

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.