Give it a REST - Tips for Designing and Consuming Public APIs

This course examines practical challenges in designing and consuming REST APIs, including how to evolve them without breaking existing clients. It also covers asynchronous operations, rate limiting, caching, and handling unexpected responses.

Syllabus

Intro
Is that really REST?
Anatomy of a REST request
Anatomy of a REST response
API design - where do you start?
An API is a contract
Versioning an API
Extending an API
How do we introduce breaking changes?
Elegant deprecation
BFF - for compatibility and tailoring
Using links to construct a user interface
Hypermedia UI (consumer/publisher)
Caching - 304 Not Modified
Last-Modified header (producer)
Rate limiting - 429 Too Many Requests
Async and REST
Mini PUT/POST.../status example
Updating FileRequest status
Over consuming (consumer)
Enumerated values (consumer)
Be specific (consumer)
Resources