Skip to content
José da Cruz

Enterprise Architect, and Life Thinker

José da Cruz

Enterprise Architect, and Life Thinker

Tag: API Design

architecture

Postel’s Law: Why Being Liberal in What You Accept Usually Backfires

josedacruz, September 24, 2026September 24, 2026

TL;DR: Postel’s Law — “be conservative in what you send, liberal in what you accept” — gets quoted as an excuse to skip validation on your API inputs. In practice, that habit doesn’t make your system more resilient; it just moves the failure further downstream, where it’s harder to trace…

Continue Reading
architecture

Hyrum’s Law: Why Every Observable Behavior of Your API Becomes Someone’s Dependency

josedacruz, August 17, 2026August 17, 2026

TL;DR: Hyrum’s Law says that if enough people use your software, every observable behavior of it — not just the parts you documented and promised — will eventually become something someone depends on. That means “we never promised that” is not the same as “it’s safe to change.” This post…

Continue Reading
architecture

Designing a Rate Limiter That Survives a Flash Sale: Token Bucket vs Sliding Window

josedacruz, August 13, 2026August 13, 2026

TL;DR: A simple “count requests per minute” rate limiter looks fine in testing but can let through double the traffic right at the boundary between two time windows — exactly when a flash sale or a bot swarm is most likely to hit you. Token bucket and sliding window algorithms…

Continue Reading
spring-boot

Learning Spring Boot from Zero to Cloud: Part 15 – Matrix Variables

josedacruz, April 2, 2025April 2, 2025

Spring Boot Matrix Variables Explained! Ever wondered how to pass structured parameters in a REST API beyond query parameters? In this video, we break down @MatrixVariable, showing you: ✅ How to Implement @MatrixVariable in Spring Boot✅ When to Use It (Best Use Cases)✅ How It Compares to @PathVariable & @RequestParam✅…

Continue Reading
  • architecture (167)
  • artificial-intelligence (6)
  • books (2)
  • courses (4)
  • decision-frameworks (4)
  • finances (1)
  • java (8)
  • life-improvement (20)
  • metrics (3)
  • observability (2)
  • puzzles and challenges (3)
  • reviews (1)
  • security (8)
  • Soft Skills (1)
  • spring-boot (36)
  • Systems Thinking (3)
  • GitHub Weekly: AI Agent Tools Trending Right Now (November 2 – November 8, 2026)
  • Designing a Distributed Session Store: Why Sticky Sessions Break Under Load
  • Essential Reading: Release It! — Why Production Is a Different Game Than Development
  • GitHub Weekly: Top 10 Trending Repos (October 26 – November 1, 2026)
  • GitHub Weekly: Architecture & Infra Tools Worth a Look (October 19 – October 25, 2026)
©2026 José da Cruz | WordPress Theme by SuperbThemes