Page MenuHomePhabricator

Only fetch content from new Page Summary MCS route when Accept header is v2.0+
Closed, DeclinedPublic

Description

NOTE: As the time of writing, v2.0 is the next major version of the Page Summary RESTBase endpoint.

We want to make sure that older clients still receive compatible responses (v1.2-) as the new Page Summary response contains a lot of breaking changes.

AC

  • For requests with the Accept: profile="https://www.mediawiki.org/wiki/Specs/Summary/1.2.0 HTTP header, the content is fetched from the MediaWiki API as it is now.
  • For requests with the Accept: profile="https://www.mediawiki.org/wiki/Specs/Summary/1.2.0 HTTP header, the content is fetched from the new Page Summary MCS route

Open Questions

  1. How many clients send requests without the profile part of the Accept HTTP header? See T170606: Add Accept header to webrequest logs
  2. At what point is returning v2.0+ content an acceptable default strategy?

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald Transcript
Jdlrobson moved this task from Incoming to Upcoming on the Readers-Web-Backlog board.
Jdlrobson added a subscriber: Jdlrobson.

When endpoint is ready we are likely to need to help this happen.

Jdlrobson changed the task status from Open to Stalled.Aug 2 2017, 6:33 PM

Blocked on T168848

@Pchelolo is this still applicable (in relation to T168848?) or would it better to just switch outright?

I think it's not applicable any more. Closing as declined.