"As a Curator, I want to get a list of the previous revisions of a page, so that I can understand how it developed over time."
GET /page/{title}/history?{older_than|newer_than={id}}
Segmented history of a page. (I'm calling it "segmented" instead of "paged" so we don't all go crazy.)
{title} is the page title.
If older_than is provided, only show the newest revisions strictly older than the given revision ID, non-inclusive.
If newer_than is provided, only show the oldest revisions strictly newer than the given revision ID, non-inclusive.
Only one of older_than or newer_than are allowed.
Request body: none
Notable request headers: none
Notable response headers: none
Body: JSON, an object with the following fields:
older: full link to API endpoint for the next older segment of results (usually the same endpoint plus "older_than" with the last revision in this segment). May be excluded if there are no known older revisions.
newer: full link to API endpoint for the next newer segment of results (usually the same endpoint plus "newer_than" parameter for first revision in this segment). May be excluded if there are no known older revisions.
latest: full link to API endpoint for the latest values, usually just this endpoint with no parameters
revisions: an array of up to 20 revision objects, each with the following information:
id: revision id
comment: edit summary of the change, provided by the user
timestamp: date of change, YYYY-MM-DDTHH:MM:SSZ
delta: +/- count of characters changed from previous
size: count of characters
user: user who made the change, object with {id, name}