Page MenuHomePhabricator

Deprecate and remove MCS endpoints from RESTBase
Closed, ResolvedPublic4 Estimated Story Points

Description

The mobile-sections endpoints were supposed to be superseded by mobile-html endpoints. We need to figure out how to deprecate the mobile-sections endpoints in RESTBase and remove them.

Event Timeline

The mobile-sections endpoints live on because they are now used by Inuka-Team for the KaiOS-Wikipedia-app. I think there was some talk of them building something more customized to their needs in the medium-to-long term but I'm not sure where that stands today. @SBisson will know more. +@sdkim and @dcipoletti also to get this on their radar if it isn't already.

@Pchelolo I just spoke with @SBisson in that making this change will indeed break the newly released KaiOS.

The request is that we simply mark these endpoints as "deprecated" to discourage new consumers to allow Inuka to migrate to PCS come Q3. Is this feasible with your sunset strategy?

The request is that we simply mark these endpoints as "deprecated" to discourage new consumers to allow Inuka to migrate to PCS come Q3. Is this feasible with your sunset strategy?

Ofc we will not simply drop the endpoints with no grace period. We have not decided how long the deprecation period for these would be, collecting data on usage and coming up with a reasonable deprecation strategy is a part of this project.

Naike set the point value for this task to 1.Dec 10 2020, 2:19 PM

Removing inactive task assignee.

DAbad added a project: API Platform.
DAbad moved this task from Incoming to Must do now on the API Platform board.
DAbad changed the point value for this task from 1 to 4.Apr 5 2022, 1:20 PM
DAbad changed the task status from Open to In Progress.Apr 26 2022, 1:40 PM
DAbad moved this task from Must do now to QA/Review on the API Platform board.
DAbad subscribed.

Patch to remove them exists. In flight

The status change immediately above should have been applied to T305506: Promote or remove experimental MW core API endpoints, not this ticket. Sorry for any miscommunication or distraction.

To be clear, we are not removing these endpoints at this time.

BPirkle subscribed.

Removing myself as assignee, as I am not actively working on this right now, and I don't want to discourage anyone else who might pick it up.

FYI the Inuka team has done the work to remove the dependency of the KaiOS app on the MCS endpoint. We are waiting for the update to be released to the app store. We were hoping for a Sept 30 deployment but it may be closer to Oct 15.

Hi, since we are getting closer to the deployment day, is there any update on that?

The app has in fact been deployed to the store last week. We don't know how long it will take for all users to upgrade to the latest version. Do you have a dashboard to monitor traffic to the MCS endpoint?

We do have the metrics for webrequests on turnilo. Which user-agent is the app using for MCS requests?

edit:
https://w.wiki/5nLx
I see some references for KaiOS

The MCS endpoints are planned to be deprecated? Is there a way to get a similar JSON parsed response that contain each different section for Wikipedia pages with other APIs?

No sure what is the exact status here, but on the size of Kiwix we have implemented the support of the new mobile-html REST end-point. Unfortunately we are not really able to create ZIM files because of https://phabricator.wikimedia.org/T349972. We still rely therefore on the mobile-section end-point.

Aklapper changed the task status from In Progress to Open.Mar 22 2025, 7:23 AM

Resetting task status from "In Progress" to "Open" as this task has been "in progress" for more than two years.

Small update here, we have released MWoffliner 1.14.0 a few weeks ago. This new version does not support the mobile-section endpoint anymore and therefore we don't rely anymore at all on mobile-section endpoint on our end.

MSantos claimed this task.
MSantos added subscribers: dr0ptp4kt, Susannaanas, TuukkaH and 8 others.