"As a Reader, I want to get a list of all pages that use a reference, so that I can understand the context of that reference."
Reverse lookup for references, probably paginated. Again, reference identity isn't fully developed here, but probably "different pages of the same book or article" and "different fragments ('page#section') of the same web page" count as "the same reference".
GET /reference/{id}/pages?(before={before}|after={after})
Get pages that use this reference.
Parameters:
- id: id of the reference
- before: only get pages before this page title
- after: page title, only get pages after this page title
Only one of before or after allowed.
Notable request headers: none
Status codes:
- 200: OK
- 404: No such reference
- 400: invalid before or after parameters, or both
Notable response headers: none
Response body: JSON object, with these properties
- next: full link to next segment of the list, or null if N/A
- prev: full link to the previous segment of the list, or null if N/A
- first: full link to the first segment of the list
- pages: array of 0-20 page objects from the schema, with (id, title, key) properties