📰 New post: Visualising API Structure with OpenAPI Visualiser

OpenAPI Visualiser turns an API specification into a browsable path hierarchy, helping you understand its overall “shape”.

I’ve modernised the project with a refreshed UI, endpoint drill-in through Swagger UI, and better performance for large specifications.

https://www.devwithimagination.com/2026/06/07/visualising-api-structure-with-openapi-visualiser/

How do you visualise APIs when designing or reviewing them?

#OpenAPI

verified by n8n: Как мы сгенерировали ноду из OpenAPI и почему пришлось выбросить рукописную версию

Привет, Хабр! Меня зовут Андрей и я развиваю портал для разработчиков в корпоративном мессенджере Пачка . Эта статья про то, как мы превратили рукописную ноду для n8n в артефакт, который генерируется из одного файла спецификации, и как она прошла официальную верификацию и встала в каталог n8n со статусом verified by n8n . По дороге мы выбросили целиком первую версию ноды и перевели всю документацию API на новый процесс генерации. Ниже — как это устроено внутри, с кодом и граблями. Если коротко, что получилось: правка в одном .tsp -файле автоматически расходится в документацию, CLI, SDK и n8n-ноду, а CI публикует всё по реестрам. Нода больше не может отстать от API, потому что собирается из того же источника.

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

#n8n #n8n_агенты #api_документация #n8n_community_nodes #n8n_custom_nodes #n8n_ai_agent #cli #sdk #openapi

Вики врёт, прод молчит: почему пора сделать OpenAPI единственным источником правды о вашем API

Я мобильный разработчик. Иногда при работе со структурами данных я имею дело с endpoint-ами, иду в вики, нахожу страницу с описанием — и не верю ей. Потому что по опыту знаю: страница описывает API таким, каким он был задуман полгода назад, а не таким, какой он сейчас. Дальше начинается знакомый ритуал: пишу в чат бэкендеру, он отвечает «глянь в сваггере», сваггер сгенерирован из аннотаций и показывает приблизительную картину, реальный ответ с сервера от неё отличается, потому что правило сериализации живёт в одном месте, а правило генерации описания — в другом. В итоге я делаю то, что делает большинство клиентских разработчиков: дёргаю endpoint «вживую», смотрю реальный JSON и верю только ему. То же самое бывает и при работе с внешними API (в том числе и солидных компаний). Это и есть проблема источника правды. У нас не один источник, а несколько, и они конкурируют. Вики — это намерение. Код бэкенда — это реализация. Реальный трафик — это факт. И когда между ними возникает расхождение (а оно возникает всегда), цена ошибки ложится в первую очередь на потребителя API: на фронтенд, на iOS, на Android, на десктоп, на внешних интеграторов. Эту боль на Habr описывали многие. Алексей, Java-разработчик ЮMoney, в статье « Как улучшить межсерверное взаимодействие и сэкономить время разработчика » формулирует её предельно прямо: «Swagger UI, который генерируется автоматом по метаданным классов, показывает очень примерное описание того, что у нас реально отдаётся из API. Поэтому фронты и мобильные разработчики не могут начать разработку, не вызвав endpoint на живую». Это не чья-то личная неаккуратность — это структурный изъян процесса, в котором правда не централизована.

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

#OpenAPI #REST #кодогенерация #swift

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.

#PHP #swaggerPHP #openAPI

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.

#FOSSFunding #OpenAPI #GNAP #Kiota

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

#Interledger #OpenPayments #OpenAPI #GNAP #OpenSource

AI-интегратор: профессия, которой нет в учебнике — я собрал её руками на n8n

Меня зовут Даниил. Я разработчик интеграций — до этого Kafka, REST, highload. В 2024–2025 мне первый раз поставили задачу, которую HR называет по‑разному: AI automation , n8n integrator , applied AI engineer . Я называю это AI‑интегратор : человек, который собирает бизнес‑процесс из событий, API и LLM — в основном без классического релиза , на no‑code/low‑code оркестраторе . Я не ML‑инженер. Я не prompt‑инженер в вакууме. Я впервые поднял и довёл до рабочего состояния self‑hosted n8n с LLM внутри pipeline: событие приходит → модель что‑то понимает → данные улетают в Google Sheets, Telegram, amoCRM / Bitrix24.

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

#AI #OpenAPI #chatgpt #n8n #n8n_ai #AI__инженер #Профессии_в_it_2027 #python #javascript #бизнеспроцессы

Сокращение ручной работы на примере Spring Boot-проекта: OpenAPI generator, QueryDsl, OpenAI

Привет, Хабр! Меня зовут Александр, я Java-разработчик в GlowByte. Работаю в практике управления рисками и комплаенс (Risk & Compliance). Хочу поделиться своим опытом и в целом рассказать о том, чем мы здесь занимаемся. А занимаемся мы автоматизацией систем управления рисками – от AML (противодействие легализации доходов) и операционных рисков до коллекшна (взыскание просроченной задолженности) и систем принятия решений. Моё направление – как раз последнее: системы принятия решений (СПР). Если коротко, мы автоматизируем стратегии, где нужно в реальном времени перерабатывать кучу входных параметров, учитывать множество факторов и выдавать сложные, комплексные решения. Типичные примеры: оценка риска, предстраховые проверки, системы мониторинга, расчет резервов, расчет комиссионных вознаграждений страховым агентам и многое другое. Чем это интересно? На выходе – не просто «да/нет», а полноценное управляемое бизнес-правило, которое можно быстро менять без переписывания кода. В этой статье хочу поделиться опытом разработки backend API на Spring Boot-проекте, где нам пришлось много работать с OpenAPI-спецификацией, динамическими запросами и тестированием бизнес-логики.

https://habr.com/ru/companies/glowbyte/articles/1040112/

#java #springboot #openapi #querydsl #бэкенд #тестирование #llm #chatgpt #api #jpa