// Topics / Rest

Rest

Definition

Rest coverage in this archive spans 6 posts from May 2016 to Mar 2022 and deals with structural tradeoffs: coupling, failure boundaries, and long-term change cost. The strongest adjacent threads are api, architecture, and versioning. Recurring title motifs include api, versioning, pick, and stop.

Key claims

  • Most pieces recommend choosing the simplest architecture that can be operated confidently.
  • Early posts lean on api and design, while newer posts lean on api and versioning as constraints shifted.
  • This topic repeatedly intersects with api, architecture, and versioning, so design choices here rarely stand alone.

Practical checklist

  • Define failure domains and data boundaries before introducing additional services or protocols.
  • Start with the newest post to calibrate current constraints, then backtrack to older entries for first principles.
  • When boundary questions appear, cross-read api and architecture before committing implementation details.

Failure modes

  • Breaking systems into many parts without clear ownership of cross-service behavior.
  • Choosing architecture for trend alignment rather than workload constraints.
  • Applying guidance from 2016 to 2022 without revisiting assumptions as context changed.

Suggested reading path

References

6 entries tagged “Rest”

    API Versioning: Pick One and Stop Overthinking It · 4 min API versioning is a maintenance commitment, not a design exercise. URL paths win for public APIs, headers for internal ones. The real discipline is not versioning -- it's avoiding breaking changes in the first place. api versioning rest I Tried Every API Versioning Strategy. Here's the One I Actually Use. · 5 min After dealing with versioning messes at multiple companies, I landed on URL path versioning for anything public. Here's why the alternatives didn't survive contact with reality. api versioning rest Your API Is a Contract You Can't Take Back · 4 min Hard-won lessons on designing HTTP APIs that survive real integrations, drawn from building fintech and mobility platforms. api design rest API Versioning: What Actually Works and What Doesn't · 4 min We tried multiple API versioning approaches at the fintech startup. URL path versioning won. Here's why, plus how to handle deprecation without burning your consumers. api versioning rest GraphQL vs REST: Pick the Boring One · 4 min Everyone wants to debate GraphQL vs REST like it's a religion. It's not. One reduces round trips, the other is dead simple to cache. Here's how I actually decide. graphql rest api API Design Principles That Stand the Test of Time · 5 min Lessons from building the fintech startup's financial data API: the REST conventions that actually matter, the ones that don't, and why consistency beats cleverness every time. api rest design
All topics →