Change Details

"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. Title is escaped for slashes Payload: empty Request headers: Status: 200 – this is the page 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.

"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.

"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. Title is escaped for slashes Payload: empty Request headers: Status: 200 – this is the pagerevision 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.