title endpoints to MediaWiki core
Open, In Progress, MediumPublic
Actions

Assigned To

Authored By

	daniel
	Sep 5 2024, 4:55 PM

Description

We want to deprecate the /api/rest_v1/page/title endpoints, but to unblock RESTbase sunsetting, we need a way to re-implement them in some other way. The easiest way would be a compatibility mode in content.v1/page/{title}/bare and content.v1/revision/{id}/bare which can be activated by a header or request parameter. We can then use the REST gateway to route requests for these endpoints to the respective core endpoint, and set the header to activate the compatibility more.

Details

Subject	Repo	Branch	Lines +/-
REST: Add items wrapper for restbase compat to some response bodies	mediawiki/core	master	+23 -22
REST: vary on x-restbase-compat header if present	mediawiki/core	master	+16 -1
REST: vary on x-restbase-compat header if present	mediawiki/core	wmf/1.43.0-wmf.24	+16 -1
REST: add restbase compat errors for some endpoints	mediawiki/core	master	+181 -21
REST: add restbase compat error handling mode	mediawiki/core	master	+114 -7
REST: add restbase compat mode for some endpoints	mediawiki/core	master	+245 -36

Customize query in gerrit

Related Objects
Search...

		Status	Subtype	Assigned	Task
		In Progress		None	T374135 Migrate RESTbase page content endpoints
		In Progress		daniel	T374136 Route /api/rest_v1/page/title endpoints to MediaWiki core

Event Timeline

daniel created this task.Sep 5 2024, 4:55 PM

Change #1070972 had a related patch set uploaded (by Daniel Kinzler; author: Daniel Kinzler):

[mediawiki/core@master] REST: add restbase compat mode for some endpoints

https://gerrit.wikimedia.org/r/1070972

gerritbot added a project: Patch-For-Review.Sep 5 2024, 4:56 PM

daniel mentioned this in T374135: Migrate RESTbase page content endpoints.Sep 5 2024, 4:59 PM

BPirkle renamed this task from Route /api/rest_v1/page/title endpoitns to MediaWiki core to Route /api/rest_v1/page/title endpoints to MediaWiki core.Sep 5 2024, 9:03 PM

daniel merged a task: T374361: Sunset /page/title/ in favor of the new MW bare endpoints.Sep 9 2024, 2:42 PM

daniel added a subscriber: ssastry.

MSantos mentioned this in T334238: Create deprecation plan for public parsoid endpoints.Sep 9 2024, 2:44 PM

BPirkle changed the task status from Open to In Progress.Sep 12 2024, 3:25 PM

BPirkle assigned this task to daniel.

BPirkle triaged this task as Medium priority.

BPirkle moved this task from Incoming (Needs Triage) to In Progress on the MW-Interfaces-Team board.

Krinkle mentioned this in T374683: Switchover plan from RESTbase to REST Gateway for rest_v1/page/html and rest_v1/page/title endpoints.Sep 14 2024, 3:54 AM

Change #1072921 had a related patch set uploaded (by BPirkle; author: BPirkle):

[mediawiki/core@master] REST: add restbase compat errors for some endpoints

https://gerrit.wikimedia.org/r/1072921

Change #1073259 had a related patch set uploaded (by BPirkle; author: BPirkle):