API Versioning Strategies: URL vs Header vs Media Type Versioning
Compare URL, header and media type API versioning on caching, routing and tooling, and learn to define breaking changes and retire old versions safely.
14 min read
Category
Backend Engineering
Runtimes, frameworks and API styles: Node.js, Bun, NestJS, Spring Boot, Python, REST, GraphQL and gRPC.
Async Request-Reply Pattern: HTTP 202 Accepted, Polling and Job Status
Design long-running HTTP operations with 202 Accepted, a job status endpoint, idempotent submission, sound polling, optional callbacks and cleanup rules.
16 min read
Build a Bun.serve API with bun:sqlite and Zero Dependencies
Build a small REST API with Bun.serve and bun:sqlite: manual routing, prepared statements, validation, migrations, graceful shutdown and tests, no npm packages.
13 min read
gRPC Streaming in Node.js: Server, Client and Bidirectional
Build server, client and bidirectional gRPC streaming in Node.js with @grpc/grpc-js, handling backpressure, deadlines, cancellation and errors correctly.
16 min read
NestJS Testcontainers: Integration Tests Against Real PostgreSQL
Run NestJS integration and e2e tests against a disposable PostgreSQL via Testcontainers, with real migrations, per-test isolation and a fast CI setup.
14 min read
Spring Boot Micrometer Tracing: Metrics and Traces from One Observation
Set up Spring Boot observability with Micrometer: one Observation API code path for Prometheus metrics and OpenTelemetry traces, with safe Actuator and sampling.
13 min read
uv vs Poetry vs pip-tools: Lockfiles for Python API Services
Compare uv, Poetry and pip-tools for API services: hash-verified lockfiles, Docker builds, CI checks, cross-platform locks and a safe migration path.
13 min read
AsyncLocalStorage Request Context and Correlation IDs in Node.js
Learn how to use Node.js AsyncLocalStorage to carry request context and correlation IDs through logs, outbound calls, and background jobs safely.
14 min read
Cursor vs Offset Pagination Performance in PostgreSQL APIs
Why OFFSET cost grows with page depth in PostgreSQL, how keyset pagination keeps it flat, and when each fits your API under real load.
13 min read
GraphQL Federation: Composing a Supergraph Across Services
How GraphQL federation composes subgraph schemas into a supergraph, plans queries across services, and when its operational cost is worth paying.
13 min read
FastAPI Dependency Injection for DB Sessions, Auth and Testing
Use FastAPI dependency injection to own SQLAlchemy session and auth lifetimes, compose Depends chains, and test cleanly with dependency overrides.
18 min read
Node.js File Upload API Design: Multipart, Presigned URLs, Limits
Learn when a Node.js file upload API should stream multipart or issue S3 presigned URLs, how to enforce size limits at every layer, and how to verify uploads.
14 min read