APIs
Build a CRUD REST API in Go With the Standard Library
Build a CRUD API in Go with the standard library: a natural key, PUT upserts, ETag and If-Match locking, and a store contract tested on memory and SQLite.
22 min read
Topic
APIs
Designing JSON, REST and gRPC interfaces that other people have to live with: versioning, pagination, validation, errors and clients.
APIs
JSON Marshaling in Go With Tags Omitempty and Custom Types
A tour of encoding/json in Go: struct tags, omitempty and omitzero, nil versus empty, time and bytes, int64 precision, HTML escaping and measured speed.
14 min read
APIs
Authentication for Go APIs With Keys Tokens and Sessions
Build Go API authentication with one Principal and three mechanisms: hashed API keys, signed bearer tokens and cookie sessions, with 401 versus 403 and CSRF.
19 min read
Web
Build a Webhook Receiver in Go With Signature Checks
Build a webhook receiver in Go that checks an HMAC signature on the raw body, rejects stale and replayed events, answers fast and processes in the background.
15 min read
APIs
API Versioning in Go and the Strategy That Ages Best
Compare URL, header, media type and date-based API versioning in Go, with one handler serving two views, a frozen v1 test and Sunset headers.
12 min read
APIs
Generate a Go Server From an OpenAPI Spec Step by Step
Generate a Go net/http server from an OpenAPI file with oapi-codegen: config, the interface, validation middleware and what generated code leaves unchecked.
12 min read
Web
Call Web APIs From Go With Typed Clients and Context
Build a typed Go client for a JSON API: context on every call, one generic request helper, an APIError you can test with errors.Is, and paging as an iterator.
17 min read
APIs
Conditional GET and ETags for Go JSON APIs Explained
Make JSON API revalidation cheap in Go: ETags from a revision column, collection tags, exact If-None-Match matching, 304 headers and 10x less work.
14 min read
APIs
Request Validation in Go APIs Without Reflection Magic
Validate Go API requests with a small collector: JSON Pointer paths, nested fields, cross-field rules, rune-aware lengths and 340 ns for a valid order.
17 min read
APIs
JSON v2 in Go and What Changes for Your Existing Code
What Go's experimental encoding/json/v2 changes: case-sensitive keys, rejected duplicates, empty arrays for nil slices, Duration formats. v1 unchanged.
8 min read
APIs
OAuth 2 Server Basics in Go for Your Own API Clients
Build a small OAuth 2 server in Go: client credentials, authorization code with PKCE, exact redirect matching, single-use codes and a scope-checking API.
21 min read
APIsGuide
REST API Design Rules for Go Services That Hold Up
REST API design rules for Go services, from URLs and methods to errors, paging and versioning, with a small linter that checks the URL rules.
13 min read
Get new articles by email
We send one email when a new article is published. No spam.