28 Resource revisions

This chapter covers

  • How to safely store multiple revisions of a single resource as it changes over time
  • How to identify individual revisions
  • Strategies for creating revisions, either implicitly or explicitly
  • How to list the available revisions and retrieve specific revisions
  • How restoration to previous revisions works
  • What to do about child resources of revisable resources

Though resources change over time, we typically discard any changes that might have occurred in the past. In other words, we only ever store what the resource looks like right now and completely ignore how the resource looked before changes were made. This pattern provides a framework by which we can keep track of multiple revisions of a single resource ...

Get API Design Patterns now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.