The Fashion for REST - Creating Beautiful APIs
summary
Defines what RESTful means by detailing the Richardson Maturity Model and concrete HTTP semantics (GET/POST/PUT/DELETE/OPTIONS) and status codes, including using 202 Accepted for asynchronous work and HATEOAS via hypermedia links. Uses concrete examples—a Tesla Model S REST-style API, a photo-tagging service that incorrectly used GET for side effects, and a GitHub gist showing async tasks that return a result resource—and recommends vendor media types for versioning while advising to use RPC when endpoints are truly command-style.
AI-written summary · about
chapters (15)
- 0:00Introduction to REST
- 1:05What REST really is
- 3:20REST vs Chinese schools
- 5:33Roy Fielding and REST
- 6:57REST principles
- 10:32Level 0: XML-RPC
- 11:34Level 1: URI identifiers
- 13:40Level 2: HTTP methods
- 17:14REST API examples
- 21:32HTTP status codes
- 28:04Level 3: Hypermedia links
- 36:17REST vs API docs
- 39:48Beyond CRUD in REST
- 44:06Content-Type and versioning
- 47:39REST versus RPC








