The API will provide 4 distinct sets of functionality:
- Returning Reading Lists for the authenticated user
- Returning the entries of a Reading List for an authenticated user
- Allow a user to mange Reading Lists and their entries
- Return changes to lists and entries (including deletions) since a provided date
=== Action API syntax
(in case option 1 is chosen above)
* `list=readinglists` to get all lists of the current user
** `rlprop=entries` to enable/disable returning the entries together with the list
** `rllimit`, `rlentrylimit`
** `list=readinglists&rllist={list_id}` to get the entries of a single list
** `list=readinglists&rlproject={project}&rltitle={title}` to get the lists containing a given page
* `list=readinglistchanges&rlcsince={date}` to get changed/deleted entries/lists
* `action=readinglists&command=[setup|teardown|create|update|delete|createentry|deleteentry|order]` for all the write operations on lists. (This is slightly against action API conventions which would put all "commands" as separate actions, which IMO would make the help interfaces unnecessarily hard to use.)
* `action=readinglistentries&command=[create|delete|order]` for all the write operations on list entries.