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

This course examines practical challenges in designing, maintaining, and consuming public REST APIs. It covers ways to evolve APIs without breaking existing clients, handle asynchronous operations and rate limits, and make client applications more reliable.

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
Updating FileRequest status
Over consuming (consumer)
Enumerated values (consumer)
Relying on link order (consumer)
Be specific (consumer)
Resources