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

#Quarkus #APIDesign #OpenAPI

Ask HN: What are Stainless users doing now that Anthropic has killed it?

Anthropic이 OpenAPI 스펙을 기반으로 다수 언어 SDK와 MCP 서버를 자동 생성해주던 Stainless를 인수 후 서비스를 종료했다. Stainless를 사용해 API 기반 AI 모델을 운영하던 여러 기업과 개발자들이 SDK 유지보수 문제에 직면했으며, OpenAI와 Google도 영향을 받았다. 사용자들은 대체 솔루션이나 오픈소스 커뮤니티의 지원을 기대하고 있으나, 마땅한 대안이 없으면 수작업 유지보수나 코드 파괴를 감수해야 하는 상황이다.

https://news.ycombinator.com/item?id=48202774

#openapi #sdkgeneration #api #anthropic #stainless

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

#Quarkus #OpenAPI #Java

At Protocol for Agents

AT Protocol은 에이전트가 API 키나 인증 없이도 사용자 데이터에 접근하고 실시간으로 쿼리할 수 있는 분산형 오픈 데이터 인프라를 제공한다. 각 사용자는 DID 기반의 개인 JSON 저장소를 가지며, 모든 기록은 공개 스키마(Lexicon)로 구조화되어 있어 에이전트 간 데이터 재사용과 상호운용성이 뛰어나다. 이 프로토콜은 에이전트 신뢰도와 평판을 영구적으로 유지하며, 에이전트 상태와 의사결정 기록을 공개적으로 관리할 수 있어 투명한 AI 에이전트 생태계 구축에 적합하다. 개발자는 간단한 HTTP 호출만으로 데이터에 접근하고 조작할 수 있어 에이전트 개발과 통합에 매우 유용하다.

https://davidgasquez.com/atproto-agents

#atprotocol #agent #decentralized #openapi #did

There are a few useful features in openapi_first 3.4:

- openapi_first/test now writes the OAD coverage report to an HTML file now instead of dumping it to the terminal
- rack apps that use the request validation middleware can throw an error object to emit an error response
- Support `encoding[<field>].contentType` on `multipart/form-data` request bodies
- New hook `before_request_validation`

Find more details in the changelog: https://github.com/ahx/openapi_first/blob/main/CHANGELOG.md#340

#openapi #ruby #rack

#aspnet now supports generating query operations for #openapi 3.2.0 !!!

https://github.com/dotnet/core/blob/main/release-notes/11.0/preview/preview4/aspnetcore.md#http-query-in-generated-openapi-documents

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