APIs
Large JSON Responses in Go Without Running Out of Memory
Serve a 200,000-row JSON export in Go by streaming rows from the database: first byte in 1 ms instead of 161, 1 MB of heap instead of 57, and gzip on the fly.
11 min read
Library
Everything you need to level up your coding skills.
APIs
Quotas and Usage Metering in Go APIs Done Correctly
Meter API usage and enforce quotas in Go: an atomic conditional UPDATE, idempotent events, weighted routes, refunds for 5xx, UTC periods and reconciliation.
18 min read
APIs
Structure JSON Responses in Go With a Consistent Envelope
How a Go API should wrap its JSON: bare resources, a data envelope for lists, empty arrays instead of null, optional totals, and why to skip a success flag.
8 min read
APIs
Custom JSON Marshalers in Go for Enums and Timestamps
Write JSON marshalers in Go for enums, dates, durations and Unix times: MarshalText versus MarshalJSON, clear errors, the pointer receiver trap and recursion.
11 min read
APIs
API Keys in Go and How to Generate Hash and Rotate Them
Generate, store and rotate API keys in Go: a prefixed format with a checksum, SHA-256 storage, throttled last-used, overlap rotation and 85 ns rejection.
13 min read
Web
Send Webhooks From Go With Retries and Request Signing
Build the sending side of webhooks in Go: signed deliveries, a retry schedule that honors Retry-After, permanent versus temporary failures and dead endpoints.
16 min read
APIs
Idempotency Keys in Go APIs for Safe Client Retries
Make POST safe to retry in a Go API with an Idempotency-Key middleware: concurrent duplicates, replayed responses, payload fingerprints and 5xx handling.
12 min read
APIs
Generate a Typed Go Client From an OpenAPI Document
Generate a typed Go client from an OpenAPI file with oapi-codegen, then wrap it: auth by request editor, Go errors from problem documents and a drift check.
12 min read
APIs
Bulk Endpoints in Go APIs and Handling Partial Failure
Design bulk endpoints in Go: atomic versus partial modes, per-item results by index, savepoints, idempotent refs, limits, and 100 creates in 1.2 ms not 18.
16 min read
APIs
The Validator Package in Go and Its Sharp Edges to Know
Use go-playground/validator in a Go API: tags, nested rules, JSON field names in errors, and the traps around zero values, dive, panics and per-call setup.
15 min read
APIs
Stream JSON in Go With the Encoder and Decoder Types
Stream JSON in Go without loading it all: an iterator over a top-level array, NDJSON with a Decoder, element-by-element encoding and a live heap of 0.02 MB.
11 min read
APIs
Rate Limiting Go APIs per API Key and per Route Cleanly
Rate limit a Go API per key and per route with token buckets: weighted costs, 429 with Retry-After, idle sweeping, a fake test clock and 123 ns decisions.
13 min read
Get new articles by email
We send one email when a new article is published. No spam.