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 (154)
  • 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)
  • spring-boot (36)
  • Systems Thinking (3)
  • GitHub Weekly: MCP Tools Trending Right Now (September 28 – October 4, 2026)
  • The Bulkhead Pattern: Why One Slow Dependency Shouldn’t Sink the Whole Ship
  • Essential Reading: A Philosophy of Software Design — Fighting Complexity One Module at a Time
  • GitHub Weekly: Top 10 Trending Repos (September 21 – September 27, 2026)
  • The Volunteer Tax: Why Raising Your Hand in a Meeting Makes You the Permanent Owner
©2026 José da Cruz | WordPress Theme by SuperbThemes