"As a Curator, I want to read a revision online, so that I can read it with my browser or HTML widget and it will load fast."
Downloading a large document encoded in JSON, then loading the HTML from the JSON into a browser or native HTML widget, is much less efficient that letting the browser or widget download the HTML itself. So, if the user is "online", we want to have two endpoints: one for the JSON representation of the page without HTML, and one for HTML only.
This is similar in requirements to T234377, so we'll use the same structure (JSON-only for metadata, streaming HTML for the HTML part). The JSON-only metadata is already covered by T231345, so only one endpoint is defined here.
GET /revision/{id}/html
Returns the revision HTML.
Payload: empty
Request headers:
Status:
200 – this is the revision content
401 - user is not authenticated and this revision is only available to authenticated users
403 - authenticated user is not allowed to read the content of the revision
404 – revision does not exist (never created or deleted)
Headers: None
Body: HTML
Reversible HTML as generated by Parsoid for the revision. No skin or navigation.