user@runtime:~/blog$ grep -l "openapi" posts/*.md

openapi

6 posts tagged with openapi.

2026-05-13 11m

HTTP QUERY: The New Method That Fixes What GET and POST Got Wrong

.NET 11 Preview 4 adds first-class support for the HTTP QUERY method -- a safe, idempotent verb that accepts request bodies. Here is how it works in ASP.NET Core, why it matters for API design, and where the ecosystem stands today.

2026-04-28 9m

Asp.Versioning Meets Built-In OpenAPI: Versioned API Documentation in .NET 10

Asp.Versioning v10.0.0 brings first-class integration with .NET 10's built-in OpenAPI library, replacing the Swashbuckle-era workarounds with a single AddOpenApi call, automatic per-version documents, and RFC 9745 deprecation headers.

2026-04-13 10m

TypedResults: The Minimal API Return Type That Writes Your OpenAPI Spec for You

TypedResults and the Results<T1, T2> union pattern give Minimal API endpoints compile-time safety, automatic OpenAPI metadata, and cleaner unit tests. Here is how to use them properly and why they should be your default.

2026-04-09 9m

Kiota: Microsoft's OpenAPI Client Generator That Understands Your API's Shape

Kiota generates strongly typed API clients from OpenAPI specs using a hierarchical request builder pattern. Here's how to use it, wire it into DI, and avoid the pitfalls that trip up most teams.

2026-01-22 3m

API Documentation with Scalar and OpenAPI in .NET

How to generate interactive API documentation in ASP.NET Core using OpenAPI and Scalar as a modern alternative to Swagger UI.

2025-09-01 4m

OpenAPI and Swagger Generation in ASP.NET Core

Generate OpenAPI specifications from ASP.NET Core APIs using the built-in OpenAPI support and Swashbuckle, with customisation for schemas, security, and documentation.