Pin baseUrl in the Gateway, Not in the Agent's Prompt
The other day an agent I was testing kept hitting production. Not on purpose, not because it was being clever. It was reading the OpenAPI spec we ha…
Tech news from the best sources
The other day an agent I was testing kept hitting production. Not on purpose, not because it was being clever. It was reading the OpenAPI spec we ha…
The first MCP server we stood up, someone on the team wrote out the tool list by hand. A JSON file with 22 entries, each describing one endpoint we…
Всем привет! Cегодня я хотел бы представить свой небольшой проект по генерации свагера для Go-проектов. Читать далее
You ship a small feature on a Tuesday. The assistant writes the whole thing in one pass: a fetch wrapper, a couple of loading states, error handling…
Spectral has been the default OpenAPI linter for years, and it did serve the community well. It made linting API descriptions in CI a normal thing,…
I'm working on Impact Gate, a warn-only PR check that tells you which consumers an API change can affect. Before claiming anything about it, I wante…
Меня зовут Антон Богун, я старший разработчик ПО в Axenix. В прошлой статье мы говорили о Doc as Code как об инженерной практике: документация живет…
Let me describe a day in the office. Tell me if it sounds familiar. You need to call the payments API. Just one request. Should take five minutes. F…
It is Monday morning. A new coding assistant looks promising, so you open a fresh chat and start the ritual: paste the API docs, explain the auth he…
If you integrated a public API in 2023, you probably read its OpenAPI spec, generated a client from it, and trusted the version number to tell you w…
I built an OpenAPI to MCP server generator for TypeScript, Python and Go. The v1 mistake: 1 endpoint = 1 tool. On a real API with 200 operations, yo…
We went looking for projects that publish an OpenAPI specification and then let anything through CI unchecked. We expected a niche. We found the def…
"The generated client keeps calling DELETE /items/{id}." "The server returns 405 Method Not Allowed." An OpenAPI spec is not just documentation. SDK…
Disclosure: I work on Mockzilla, which competes with Mockoon. Everything below was run on one laptop, and there is a link to the longer comparison a…
How to Generate Karate API Tests from OpenAPI — Without Creating a Maintenance Nightmare Generating API tests from an OpenAPI file sounds like an ea…
Disclosure: I work on Mockzilla, which competes with Stoplight Prism. Everything below was measured on my laptop, and there is a link to the longer…
С документацией к API есть две крайности, и обе плохие: написанная руками врёт через полгода, сгенерированная целиком стирает всё осмысленное, что в…
Breaking change в REST API часто обнаруживают слишком поздно — уже на интеграционном стенде. Разберём, какие риски можно поймать раньше, где помогаю…
Disclosure: I work on Mockzilla, which competes with WireMock. Everything below was run on my laptop today and every claim links to its source. Ther…
If you have ever called an OpenAI-compatible API with streaming enabled and received... nothing , you are not alone. No error, no exception — just a…
410 вариантов писем, сотня микросервисов и до 15 файлов, которые приходилось править ради одной нотификации. Добавление письма превратилось в квест:…
Мы устали искать Swagger по чатам и написали свой агрегатор. — Где актуальный контракт сервиса рассрочек? — В репозитории. — В каком? — Сейчас найду…
Масштабирование автотестов — закономерный этап развития любого растущего проекта. С увеличением количества автотестов меняются требования к архитект…
Nim doesn't have a lot of options for building HTTP APIs with the kind of batteries-included developer experience you get in frameworks like FastAPI…
OpenAPI describes an API. Agent Readiness describes whether an agent can actually use it. Your API has a complete OpenAPI spec. Every endpoint, sche…
Привет! Я Дмитрий, старший Angular-разработчик в команде Klecks — платформы для разметки данных AI-Центра Т-Банка. Последние годы мы жили с NSwag: о…
В августе 2023-го я писал здесь про свой бандл для JSON-RPC API на Symfony. С тех пор он дорос с 1.x до 5.1 и работает в нескольких продакшенах - от…
How deterministic context batching reduced approximate token usage by ~81.7% while building an agentic API testing prototype See It in Action I also…
If you've worked with REST APIs, you've probably encountered Swagger. Many developers initially think: Swagger = API documentation That's not comple…
Почему API-First уже недостаточно и что меняется, когда SDD строится на .md-файлах и обязательном участии агентов? В агентном SDD спецификация стано…