Page MenuHomePhabricator

Reading List REST Interface: remove Action API endpoints
Open, LowPublic

Description

Once the existing RESTBase "lists" endpoints are replaced by MediaWiki REST API endpoints that do not call Action API endpoints, remove the existing Action API endpoints from the Reading Lists extension. This will reduce ongoing code maintenance. These endpoints are already marked as unstable, and it has already been identified that there are no external callers of concern that are bypassing RESTBase and directly calling these endpoints.

See the associated Miro board for endpoint map.
See task T336693: Re-implement reading lists REST interface outside RESTBase for context and details.

  • Determine whether to keep readinglistentries for use as a generator with action=query (see comment below).
  • Mark existing endpoints to be removed as deprecated (technically unnecessary, as they're already marked unstable, but doesn't hurt and is polite, given how long they've existed).
  • Remove endpoints

Event Timeline

I'd consider keeping readinglistentries which offers a natural way to use reading lists (as a generator, with all sort of data enrichment provided by other modules) that's specific to the action=query framework. The other action API modules don't really provide anything that couldn't be better done in the REST API.