The Hypermedia API
summary
Argues that designing an API with hypermedia at its core yields real, testable benefits: use HTTP methods and headers to get caching and safe idempotent actions, follow the three Richardson maturity levels to move from RPC to REST, choose a media type like HAL and register link relations so clients can discover edit and next links, use embedded links or the zoom pattern to cut requests, and publish a PHP HAL generator on GitHub that actually works in demos.
AI-written summary · about
chapters (11)
- 0:00Introduction to hypermedia
- 2:45The Richardson Maturity Model
- 5:18Level zero: The swamp of POX
- 8:21Level one and two: Resources
- 12:37HTTP verbs and state
- 15:54Level three: Hypermedia
- 22:00Link relations and registries
- 27:29Selecting markup formats
- 31:13Hypermedia in action
- 33:44Efficiency and patterns
- 37:58Q&A and closing
related talks
44mDesigning Hypermedia APIs
01h 02mHypermedia and the Rest of REST
28mDesigning Hypermedia APIs
47mHypermedia IRL
42mHypermedia - less hype, more media please
43mHow the Web Evolves with Hypermedia
58mHypermedia APIs and the Future of AI Agentic Systems
30mThe internet of things challange:building APIs that last for decades