APIs & the web
- api
Designing an API for Time Series Data
Range queries, downsampling, and why a time-series endpoint breaks the normal REST pagination rules — a small side note from building one for a monitoring tool.
Read the article - rest-api
Design a REST Contract Around Resources and Business Transitions
A guide to separating resource management from business state transitions in a document-signing workflow.
Read the article - rest-api
Choose HTTP Error Statuses Without Hiding the Real Failure
A guide to distinguishing between 4xx and 5xx errors using a private photo album scenario to drive client-side recovery.
Read the article - rest-api
HTTP Methods and Successful Responses: One Consistent Guide
A deep dive into safe and idempotent semantics for POST, PUT, PATCH, and DELETE using a playlist API scenario.
Read the article - validation-errors
Validate Input, Business Eligibility and Database Invariants
A deep dive into the three layers of validation using a workshop registration scenario to prevent invalid data and race conditions.
Read the article - validation-errors
Turn Domain Exceptions into a Stable API Error Contract
Implementing a boundary between domain-specific failures and a consistent ProblemDetail API response using RestControllerAdvice.
Read the article