Self-Documenting APIs with OpenAPI and Swagger in Ktor

Wed, 13 May 2026 00:00:00 +1000

Side projects are a good place to do things properly. Not because the project demands it, but because you want the practice.

My ACC dashboard project — laptime-insights-server — is a Ktor-based REST API. I added OpenAPI annotations and a Swagger UI. It’s not strictly necessary for a personal tool running on localhost. I added it because it’s something you’d do on a real project, and because the result is genuinely useful.

Anatomy of a Search Endpoint: Filter, Sort, Paginate, HATEOAS

Mon, 11 May 2026 00:00:00 +1000

Anatomy of a Search Endpoint: Filter, Sort, Paginate, HATEOAS

A walk through GET /api/1/sessions in the Laptime Insights server — from the Ktor route, down through the use case and persistence port, into the Exposed query, and back out as a HATEOAS page that the React frontend uses to render a sortable table.

The feature is small but it touches every layer, so it’s a good example of how clean architecture lets each concern live in exactly one place: the domain decides what’s sortable, the repository decides how that maps to a column, the resource decides how it appears on the wire, and the UI decides how to render it. Nothing leaks.

Hateoas on Pauls Blog

Self-Documenting APIs with OpenAPI and Swagger in Ktor

Anatomy of a Search Endpoint: Filter, Sort, Paginate, HATEOAS

Anatomy of a Search Endpoint: Filter, Sort, Paginate, HATEOAS