Perspectives matter:Deliver value with hypermedia
summary
Argues that APIs must be designed for callers and shows a concrete fix: a SoundCloud search returns a 404, then an inconsistent JSON payload with an array, an object and “19 more tracks,” hiding a catalog of ~100 million songs from automated agents. Demonstrates using the JSON API media type (+json), embedding href and links, and adding pagination via the Link header to expose next/related resources and recommendations. Builds sample responses that restore discoverability for crawlers, monitors, agents and human-driven clients and shows the approach working on the example.
AI-written summary · about
chapters (11)
- 0:00Intro
- 0:36Hypermedia
- 1:08APIs
- 1:49Hiding complexity
- 2:35API
- 3:15User Interface
- 4:04Human Driven Client
- 4:43Monitor Client
- 5:19Script
- 6:30Agent
- 11:41Media types
