#openapi — Public Fediverse posts
Live and recent posts from across the Fediverse tagged #openapi, aggregated by home.social.
-
Symfony JSON-RPC API Bundle три года спустя: что боевая эксплуатация сделала с кодом
В августе 2023-го я писал здесь про свой бандл для JSON-RPC API на Symfony. С тех пор он дорос с 1.x до 5.1 и работает в нескольких продакшенах - от финтех-инструментов до HRM-системы. Честный отчёт: 17 найденных отклонений от спецификации, приватные поля, утекавшие в ответы, CORS-заголовок через запятую - и что из этих уроков стало фичами бандла.
-
You are a #software #developer?
You write code with a public #API?
You want a beautiful styled and polished API reference following the #OpenAPI specification?I've done a thing.
#periwinkle, the OpenAPI documentation generator.
Check out the live demo here:
https://phranck.github.io/periwinkle/Its repository you'll find here:
https://github.com/phranck/periwinkle -
You are a #software #developer?
You write code with a public #API?
You want a beautiful styled and polished API reference following the #OpenAPI specification?I've done a thing.
#periwinkle, the OpenAPI documentation generator.
Check out the live demo here:
https://phranck.github.io/periwinkle/Its repository you'll find here:
https://github.com/phranck/periwinkle -
Семантическая целостность в ООП-системах: онтологический слой LOGOS-κ и SemanticDB
Аннотация. Объектно-ориентированное программирование (ООП) предоставляет мощные механизмы для структурирования кода, но не фиксирует смысл предметной области. Изменения...
#Семантическаяцелостность #ООП #онтологическийслой #LOGOSκ #SemanticDB #ΛУниверсум #NIGC #онтология #HabeasWeights #FAIRCARE #DbC #JSON #Turtle #OpenAPI #GraphQL #GraphML #Python #искусственныйинтеллект
-
Семантическая целостность в ООП-системах: онтологический слой LOGOS-κ и SemanticDB
Аннотация. Объектно-ориентированное программирование (ООП) предоставляет мощные механизмы для структурирования кода, но не фиксирует смысл предметной области. Изменения...
#Семантическаяцелостность #ООП #онтологическийслой #LOGOSκ #SemanticDB #ΛУниверсум #NIGC #онтология #HabeasWeights #FAIRCARE #DbC #JSON #Turtle #OpenAPI #GraphQL #GraphML #Python #искусственныйинтеллект
-
Контрактное тестирование без единой строки кода: наш инструмент, наши грабли и честный разбор альтернатив
Как организовать контрактное тестирование, если у вас 150+ микросервисов, 10 команд и QA есть далеко не везде? В Nexign перепробовали готовые инструменты, дважды откатили собственные решения — и в итоге за четыре дня собрали прототип, который за полтора года превратился в рабочий инструмент без единой строки тестового кода. Ведущий инженер Максим Дубинин рассказывает, что не так с Dredd и Pact и почему иногда проще сделать своё.
https://habr.com/ru/companies/nexign/articles/1063686/
#контрактное_тестирование #микросервисы #тестирование_api #openapi #oasis #pact #python #тестирование_без_кода #OAS3 #ProviderDriven_Contract_Testing
-
How open standards drive modern AI agent development.
Standardized layers make agents modular, portable, and safe:
* Workspace Context (#AGENTSmd): Repo context and guidelines
* Governance (#agf): Identity, prompts, and safety guardrails
* Task Skills (#SKILLmd): Reusable procedural playbooks
* Connectivity (#MCP, #OpenAPI): Universal tool and API integrationFrom custom hacks to clean, interoperable agent stacks.
#AIAgents #DevCommunity #SoftwareEngineering #AI #LLM #standards -
How open standards drive modern AI agent development.
Standardized layers make agents modular, portable, and safe:
* Workspace Context (#AGENTSmd): Repo context and guidelines
* Governance (#agf): Identity, prompts, and safety guardrails
* Task Skills (#SKILLmd): Reusable procedural playbooks
* Connectivity (#MCP, #OpenAPI): Universal tool and API integrationFrom custom hacks to clean, interoperable agent stacks.
#AIAgents #DevCommunity #SoftwareEngineering #AI #LLM #standards -
Назад в 2005-й. API-first как третья пилюля от деградации проекта под LLM
Агент отчитался: экран настроек готов. Поля редактируются, после сохранения выскакивает тост «Сохранено». Я нажал F5 — все настройки вернулись к дефолтным. Бэкенда под формой не существовало: агент выяснил это в первые минуты и вместо того, чтобы сказать мне, молча положил данные в локальный стейт и нарисовал тост. Ни один чекер из моих прошлых статей этого не поймал — и не мог: деградация пришла со шва между фронтом и бэкендом, единственной границы, через которую не проходит ни компилятор, ни анализатор зависимостей. Под катом — как этот шов гниёт под LLM и как его чинит contract-first: генерация серверных интерфейсов и клиента из одного OpenAPI-файла, политика ломающих изменений, правило «не симулируй — расширяй контракт». Попутно — зачем возвращаться к идее, которую мы выбросили вместе с WSDL, и какая из моих проверок после всего этого молча перестала работать. Третья часть цикла, читается самостоятельно.
https://habr.com/ru/articles/1063096/
#llm #aiагенты #claudecode #vibecoding #чистая_архитектура #openapi #apifirst #contractfirst #кодогенерация #archunit
-
Document Driven Development: превращаем хаос разработки в порядок с помощью TypeSpec и не только
Всем привет! Меня зовут Егор Гурин и я разработчик в компании MTC Web Services. Работаю в стриме, который занимается разработкой контактного центра МТС. Практически любые обращения клиентов в компанию, будь то неработающий интернет или вопрос по заказу в интернет-магазине, проходят через нас. Продукт большой, у нас несколько команд и множество интерфейсов интеграции как между самими командами, так и с внешними вендорами, поэтому не согласованные вовремя контракты могут привести не просто к потере времени, но и задержать выход фичи в прод. В этом материале я поделюсь инструментами, которые помогли наладить процессы в нашей команде в рамках методологии Document Driven Development, — возможно, вам она знакома под такими терминами как design-first или API-first. Покажу, как в удобной форме описывать контракты с помощью TypeSpec, использовать мокирующие сервера не дожидаясь реализации серверной, а еще — расскажу про инструмент кодогенерации на Go и автотесты с помощью Schemathesis. Читать дальше
https://habr.com/ru/companies/ru_mts/articles/1061706/
#design_first #document_driven_development #typespec #oapicodegen #schemathesis #api_first #openapi #openapi_generator
-
A post I wrote about securing an #OpenAPI scheme using Duende IdentityServer gets a decent amount of reads a month (https://duendesoftware.com/blog/20251126-securing-openapi-and-swagger-ui-with-oauth-in-dotnet-10)
But recently, a community member asked for recommendations (https://github.com/orgs/DuendeSoftware/discussions/584): "Microsoft says this, you say that…”
Funny enough, Duende's BFF Security Framework can be adapted to secure Swagger UI without dealing with tokens in the browser. See the video below. #dotnet #aspnetcore
-
A post I wrote about securing an #OpenAPI scheme using Duende IdentityServer gets a decent amount of reads a month (https://duendesoftware.com/blog/20251126-securing-openapi-and-swagger-ui-with-oauth-in-dotnet-10)
But recently, a community member asked for recommendations (https://github.com/orgs/DuendeSoftware/discussions/584): "Microsoft says this, you say that…”
Funny enough, Duende's BFF Security Framework can be adapted to secure Swagger UI without dealing with tokens in the browser. See the video below. #dotnet #aspnetcore
-
Пятая кнопка за вечер. Архитектура фронтенда под контекст LLM
К концу второго месяца vibe coding на фронте моего пет-проекта жили пять компонентов кнопки, четыре спиннера, компонент страницы на 700 строк и шапка, которая показывала один баланс, пока модалка рядом показывала другой. LLM-агент писал всё это уверенно, быстро и с хорошим стилем кода. Фронтенд под LLM деградирует даже быстрее бэкенда — и тому есть причины: от качества обучающей выборки, где вперемешку лежат три поколения React, до самой природы JSX, где разметка, логика и состояние легально живут в одном файле. Под катом — что в итоге сработало: Feature-Sliced Design, урезанный до трёх слоёв, как карта для агента; dependency-cruiser в роли архитектурного контракта, который нельзя нарушить; кодогенерация API-клиента из OpenAPI вместо доменной модели; за что я простил Tailwind; и честно — про самое слабое место конвейера: агент, который верстает вслепую. Это продолжение статьи про бэкенд, но читается и само по себе.
https://habr.com/ru/articles/1060634/
#llm #aiагенты #claudecode #vibecoding #чистая_архитектура #featuresliced_design #nextjs #dependency_check #tanstack_query #openapi
-
Можно ли аналитику в 2026 году положиться на ИИ и агентов или ещё нет?
В какой-то момент у нас, как и у многих команд, появился соблазн проверить: а можно ли уже не просто просить AI «написать user story», а действительно встроить его в рабочий процесс аналитика? Например, дать агенту вводные по задаче, макеты в Figma, примеры документации и требования к оформлению, и получить на выходе нормальный Use Case, API-спецификацию, PlantUML-диаграмму и аккуратную страницу в Confluence. Звучит красиво. Особенно если вы когда-нибудь вручную переносили сценарии из заметок в Confluence, сверяли шаги с макетами, оформляли вкладки с HTTP-запросами, проверяли коды ошибок и пытались не забыть все вопросы, которые «надо потом уточнить». В статье расскажу, насколько мы близки к этой утопии — как протестировали работу ИИ в реальном аналитическом процессе в нескольких кейсах: для подготовки Use Case, аналитических артефактов, публикации в Confluence и в работе с Figma.
https://habr.com/ru/companies/alfa/articles/1059296/
#системный_анализ #системный_аналитик #AIагенты #ИИ_в_аналитике #Use_Case #OpenAPI #APIспецификация #Confluence #Cursor #техническая_документация
-
#ASPNETCore updates in .NET 11 Preview 6 | by Dan Roth
-
#ASPNETCore updates in .NET 11 Preview 6 | by Dan Roth
-
Redocly + Dockerで複数のOpenAPI YAMLを1つのドキュメントポータルに統合した話
https://qiita.com/dev-ogawa/items/cedbcac3599cfd970348?utm_campaign=popular_items&utm_medium=feed&utm_source=popular_items -
Ты не найдёшь эту ошибку. Потому что её нет в твоём коде. Как Self-describing API спасает от чужих рефакторингов
О том, как динамическая документация (Self-describing API) помогает синхронизировать фронт и бэк без ручного контроля, экономит 25 часов команды в неделю и избавляет от поиска багов в чужом коде. История внедрения, примеры кода, подводные камни и честный разбор, где это работает, а где нет. Для фронтенд-разработчиков, тимлидов и всех, кто хочет тратить время на фичи, а не на синхронизацию с бэком. Узнать, как это работает
https://habr.com/ru/articles/1056692/
#javascript #typescript #restapi #api #openapi #архитектура #фронтенд #backend #клиентсерверная_архитектура
-
Query‑first подход или как из SQL запросов или MongoDB контрактов получить готовое REST API
Я давно хотел убрать из backend‑разработки одну особенно липкую рутину: когда для каждой новой сущности снова и снова приходится собирать одни и те же слои REST API — repository, service, handlers, request/response модели, OpenAPI, auth, тесты, curl‑примеры, Docker и прочую инфраструктуру. В этой статье рассказываю про query‑first подход и open‑source Go CLI rest , который позволяет реализовать эту идею. Смысл простой: если SQL‑запросы или MongoDB‑контракты уже описывают, какие операции нужны приложению, то из них можно сгенерировать согласованный каркас REST‑сервиса. В статье показано, как это работает для PostgreSQL и MongoDB, что именно генерируется, что такое rest doctor и почему цель инструмента — не заменить бизнес‑логику, а снять первые 80–90% повторяющейся ручной работы.
https://habr.com/ru/articles/1056034/
#Go #REST_API #backend #генерация_кода #SQLC #PostgreSQL #MongoDB #OpenAPI #queryfirst #CLI
-
Контракт из кода, клиент из контракта: избавляемся от тройного дублирования в API
Обычно процесс разработки API выглядит так: мы пишем контроллер. Затем каким-то образом его документируем. После чего фронтер, опираясь на такую документацию, пишет клиент. Мы делаем одну и ту же работу трижды. В прошлой статье я рассказывал, как избавиться от первого дублирования. С помощью бандла sunrise-studio/symfony-openapi можно генерировать OpenAPI-документ из кода, минуя процесс документирования. Но это решает проблему только наполовину. Если OpenAPI-документ вытекает из кода, то клиент должен вытекать из OpenAPI-документа. Иначе написание клиента – и есть то самое дублирование. В этой статье я расскажу как замкнуть цепочку: Controller → OpenAPI → Client → Feature Где каждый последующий шаг вытекает из предыдущего, а не дублирует его.
https://habr.com/ru/articles/1055764/
#openapi #openapi_generator #swagger #php #symfony #react #typescript #javascript #axios #orval
-
I am looking for feedback about this feature which integrates Sinatra with openapi based request validation and routing.
What do you think about this?
https://github.com/ahx/openapi_first/pull/483 -
I am looking for feedback if this feature which integrates Sinatra with openapi based request validation and routing.
What do you think about this?
https://github.com/ahx/openapi_first/pull/483 -
🚀 Initial release of OpenAPI Arazzo for .NET is out!
This release provides a #dotnet implementation of the #OpenAPI #Arazzo specification, making it possible to parse, build, serialize, and validate Arazzo workflow documents.
Key highlights:
• Core Arazzo object model support for documents, workflows, steps, parameters, inputs, actions, components, and references
• JSON/YAML parsing and serialization
• Validation for required fields, references, runtime expressions, duplicate parameters, action targets, operation paths, and document integrity
• Support for Arazzo 1.0.x documents and external schema/reference resolutionAs a bonus, it ships with multiple ways to use it:
• .NET library: `BinkyLabs.OpenApi.Arazzo`
• CLI: `dotnet tool install -g BinkyLabs.OpenApi.Arazzo.Tool` (to validate documents)
• #Docker image: `ghcr.io/binkylabs/openapi-arazzo-dotnet:1`
• #GitHub Action: `BinkyLabs/openapi-arazzo-dotnet@v1`Feedback is most welcome! And thank you to the @Interledger for sponsoring this work!
-
🚀 Initial release of OpenAPI Arazzo for .NET is out!
This release provides a #dotnet implementation of the #OpenAPI #Arazzo specification, making it possible to parse, build, serialize, and validate Arazzo workflow documents.
Key highlights:
• Core Arazzo object model support for documents, workflows, steps, parameters, inputs, actions, components, and references
• JSON/YAML parsing and serialization
• Validation for required fields, references, runtime expressions, duplicate parameters, action targets, operation paths, and document integrity
• Support for Arazzo 1.0.x documents and external schema/reference resolutionAs a bonus, it ships with multiple ways to use it:
• .NET library: `BinkyLabs.OpenApi.Arazzo`
• CLI: `dotnet tool install -g BinkyLabs.OpenApi.Arazzo.Tool` (to validate documents)
• #Docker image: `ghcr.io/binkylabs/openapi-arazzo-dotnet:1`
• #GitHub Action: `BinkyLabs/openapi-arazzo-dotnet@v1`Feedback is most welcome! And thank you to the @Interledger for sponsoring this work!
-
Оптимизация без AI: как я автоматизировал API-ручки и типы
На прошлой неделе я снова потратил полдня на то, чтобы понять, почему фронт падает после обновления бэка. Локально работало, а на стейдже ошибка. Оказалось, бэкендер переименовал поле в ответе, но не обновил документацию и не предупредил команду. Я узнал об этом только когда код упал на стейдже - вручную править ручку пришлось уже постфактум, разбираясь с ошибкой. С этим надо было что-то делать.
https://habr.com/ru/articles/1053396/
#OpenAPI #Swagger #генерация_клиента #TypeScript #API #фронтенд #автоматизация
-
Как мы превратили Swagger из документации в двигатель API-автотестов
Всем привет! Меня зовут Олег Малышев. Я один из лидеров стека тестирования в компании «ТехВилл» Мы продолжаем разговор о том, как применять ИИ в тестировании. В этой статье расскажу, как мы пишем API-автотесты с помощью OpenAPI Generator, Cursor/Claude Code и автоматически считаем покрытие по Swagger через swagger-coverage. Раньше я уже записывал большое двухчасовое видео по Cursor , где показывал в том числе, как мы генерируем автотесты. Но с тех пор подход немного изменился: мы сильнее завязались на OpenAPI-контракт, добавили Swagger Coverage, JSON-отчёты для LLM и специальные skills для генерации недостающих тестов.
https://habr.com/ru/companies/vkusvill/articles/1050894/
#вкусвилл #qa #api_testing #автотесты #openapi #swagger #swagger_coverage #llm #cursor #gitlab_ci
-
Are you into APIs and SDKs?
Are you in an expert in C# and Rust? Do you have a Git commit history to prove it?
@Interledger is looking to fund adding Rust support in Kiota—the OpenAPI-based SDK generator used by Microsoft and GitHub.
(Boosts welcomed!)
https://interledger.org/grant/open-payments-sdk?ref=activitypub
-
Are you into APIs and SDKs?
Are you in an expert in C# and Rust? Do you have a Git commit history to prove it?
@Interledger is looking to fund adding Rust support in Kiota—the OpenAPI-based SDK generator used by Microsoft and GitHub.
(Boosts welcomed!)
https://interledger.org/grant/open-payments-sdk?ref=activitypub
-
[ APIエンドポイント入出力定義の課題とその見直し案 #oRPC #OpenAPI #SchemaType #StandardSchema ]
https://github.com/misskey-dev/misskey/discussions/17609 -
Как я подключал YandexGPT к AI-агентам (OpenCode, Pi, Hermes и Claude Code)
Недавно исследовал интеграцию разных моделей. После танцев с бубном вокруг GigaChat решил проверить Yandex Cloud. Оказалось, нативная поддержка OpenAPI решает проблему без кастомных прокси. Внутри — готовые конфиги для OpenCode, Pi, Hermes и нюансы работы с Claude Code.
-
OpenAPI без #[OA\...]: как я сделал генератор документации для Symfony
В прошлой статье я уже рассказывал, как однажды устроился на работу и получил пачку «интересных» задач: вручную синхронизировать OpenAPI, оформленный в комментариях к коду, с самим кодом в десятке сервисов. Тогда это звучало как начало анекдота, но мне было не до смеха. С тех пор я сменил работу. И, как будто вселенная решила проверить моё чувство юмора, я снова вижу API, где контракт живёт рядом с кодом в ручных #[OA\...] атрибутах. И это важный момент. Это не история про одну конкретную компанию, один неудачный проект или один старый сервис, который все боятся трогать. Я вижу этот подход в разных местах.
https://habr.com/ru/articles/1047686/
#OpenAPI #Symfony #PHP #Swagger #DTO #View_objects #API #документация #автогенерация #routes
-
@odrotbohm My advice for years has been that if you feel like you need GraphQL, your API is designed poorly and you should fix the API. #ContractFirst, #OpenAPI, and #APIContracts should have been used for the UI/UX people to communicate with the backend team what they need, when, and how much.
-
@odrotbohm My advice for years has been that if you feel like you need GraphQL, your API is designed poorly and you should fix the API. #ContractFirst, #OpenAPI, and #APIContracts should have been used for the UI/UX people to communicate with the backend team what they need, when, and how much.
-
Как я прикрутил GigaChat к OpenCode и что из этого понял
Мне было интересно проверить GigaChat/GigaCode не в обычном чате, а в нормальной агентной среде разработки. То есть не “ответь на вопрос”, а вот это всё: tools , function calling , streaming , MCP-инструменты , история диалога и работа внутри реального проекта. Для проверки я подключил GigaChat к OpenCode через TypeScript-плагин. Простой текстовый запрос завёлся быстро, а дальше началось самое интересное: OpenAI-like API оказался похожим на совместимый агентный протокол только снаружи. Внутри пришлось собирать отдельный слой совместимости.
https://habr.com/ru/articles/1046321/
#GigaChat #GigaCode #OpenCode #ИИагенты #агентная_разработка #function_calling #MCP #OpenAI_API #OpenAPI
-
The Mastodon #openapi spec and #dart client have been updated to 4.6.
- https://abraham.github.io/mastodon-openapi/
- https://pub.dev/packages/mastodon/versions/1.0.0-beta.10 -
When using swagger-php, where do people put the attributes when an endpoint has many fields (50+)? Adding this inline in the Class makes the code unreadable.
-
RE: https://interledger.social/@Interledger/116681423013207892
Chris Wood, @handrews, and @vincentbiret are longtime, distinguished contributors to the OpenAPI ecosystem.
I feel so grateful and fortunate to work with the @Interledger SDK Grant to fund their efforts to keep advancing free and open source software and standards.
-
Developer experience matters.
The Interledger Foundation's SDK Grant Program is supporting projects that improve the broader API ecosystem through enhanced OpenAPI security automation, GNAP support, and Arazzo workflow capabilities in Kiota.
Congratulations to grantees Henry Andrews, Chris Wood, and Vincent Biret.
Read more about the projects and their impact on open standards and interoperable systems:
https://interledger.org/news/sdk-grant-funds-security-features-openapi-specification-and-arazzo-workflow-support-kiota -
The #mastodon collections APIs in #OpenAPi format https://abraham.github.io/mastodon-openapi/#tag/collections
-
A lot of teams say they “handle errors” when what they really mean is that exceptions eventually turn into JSON.
This piece pulls together the Quarkus reading path for RFC 9457, HTTP response design, OpenAPI, versioning, and deprecation so the unhappy path becomes part of the contract instead of an afterthought.
https://www.the-main-thread.com/p/quarkus-api-errors-rfc9457
-
OpenAPI gets weird the moment the contract depends on who is reading it.
This Quarkus walkthrough uses @OpenApiFilter(RUNTIME_PER_REQUEST) plus a Vert.x @RouteFilter so /q/openapi drops premium operations for basic tenants and keeps Swagger UI honest.
https://www.the-main-thread.com/p/quarkus-openapi-filter-tenant-swagger
-
Let's say you create an API, with openAPI....
And you want to provide the same results as the APi as a library, instead of REST calls.
Is there an easy way to "provide" it?
I remember back in the time was a swagger code-gen.
I'm thinking about providing an API but providing it as an library in PHP/JS/Java/Python or whatever is needed.
(If possible, writing the API in Kotlin)How is this done nowadays? Any hints welcome, thx.
#openapi #swagger #swaggercodegen #rest #api #library #developerlife
-
The YAML was fine. The actual problem was one stray key, eleven levels deep, that OpenAPIKit rejected and Yams wrapped in a DecodingError pointing nowhere useful. The real error was three layers in.
I lost an afternoon. Then a morning the next week. Then I built OpenAPIDoctor: a typed validator and auto-repair CLI for OpenAPI 3.0/3.1, on OpenAPIKit, tested across 594 YAML files.
#Swift #OpenAPI -
This is noteworthy because I’m speaking about JSON Schema in a talk at @phptek next week (the talk is about OpenAPI).
-
New release for @ehuelsmann/openapi-validator: v0.17.0 our #javascript and #typescript #validator for #openapi documents
This release changes typescript module resolution from node10 to node16, adds usage documentation, migrates eslint to v10 and upgrades as many dependencies to their latest versions as possible.
See: https://www.npmjs.com/package/@ehuelsmann/openapi-validator
Changelog: https://github.com/ehuelsmann/OpenAPIValidators/releases/tag/v0.17.0 -
🪧 ConnectRPC: Where is it now?: Reflecting on two years of ConnectRPC: How it evolved from a gRPC alternative to a complete API ecosystem.
https://kmcd.dev/posts/connectrpc-where-is-it-now/
#Connectrpc #Grpc #Protobuf #Api #Rpc #Go #Golang #Http3 #Openapi -
🪧 ConnectRPC: Where is it now?: Reflecting on two years of ConnectRPC: How it evolved from a gRPC alternative to a complete API ecosystem.
https://kmcd.dev/posts/connectrpc-where-is-it-now/
#Connectrpc #Grpc #Protobuf #Api #Rpc #Go #Golang #Http3 #Openapi -
The biggest US-based PHP conference of the year is coming up in less than a month, and you don’t want to miss it!
Join me at PHP Tek! I’ll be giving talks on OpenAPI and OAuth / OpenID.
-
via @dotnet : Combining API versioning with OpenAPI in .NET 10 applications
https://ift.tt/io6TkxZ
#APIVersioning #OpenAPI #AspVersioning #Asp.Versioning #MicrosoftOpenApi #ASP.NETCore #MinimalAPIs #Controllers #DotNet10 #DOTNET #SwaggerUI #Scalar #OpenApiDocume…