Code Is All You Need
How we generate our OpenAPI spec directly from the Go types that power our runtime API.
Hello, I'm @dane_albaugh. Here, I share my thoughts and learnings on API design and musings on other topics that interest me.
I'm really interested in great craftsmanship; the medium of craft is not that important.
Products
Articles
2026
Read article
Declarative API Endpoints
Building a declarative, type-safe API framework using Go generics, struct tags, and reflection to eliminate repetitive HTTP handler code.
Designing a Passively Safe API
How to design an API that handles external API failures, async tasks, and retries gracefully.
2025
Anatomy of an API
HTTP API Design — Part 4
A closer look at the layers, components, and responsibilities inside a well-structured API.
API Design Principles
HTTP API Design — Part 3
Philosophies and patterns for building APIs that stand the test of time.
HTTP Fundamentals
HTTP API Design — Part 2
An overview of HTTP and its semantics.
Series Introduction
HTTP API Design — Part 1
A comprehensive guide to the art of building robust, scalable, and user-friendly HTTP APIs.