Upcoming Backwards Incompatible Changes

[David Cramer]

Due to capacity and performance concerns we're going to have to make some backwards incompatible changes to several endpoints in the near future. I don't have a precise date yet, but I wanted to open this up as early as possible.

The following API methods will no longer allow you to retrieve more than 1000 entries:

- forums/listMostLikedUsers

- users/listMostActiveForums

- threads/listPopular

- threads/listMostLiked

The above endpoints also would no longer allow any non-standard pagination (such as the since clause), and likely will not allow you to specify an order.

We will be providing a new endpoint as an alternative to listPopular, which will allow you to specify an interval in which you want popular threads (e.g. I want the most popular threads from the last 7 days). This endpoint will also have a limit on the number of entries (likely 1000) that can be paginated through.

We are also highly considering removing complex queries from all endpoints. What we mean by complex, are queries which allow you to select data from an arbitrary list of filters (e.g. these 3 forums and this author). With this change, you would only be able to filter on a single forum, or a single category, or a couple of predefined selectors, such as :moderated (your moderated forums) and :all (all forums). This affects a large portion of the API endpoints.

I wanted to get a call for feedback before we make any of these (fairly drastic) changes. Do you have a use case for something that we've mentioned we'll be removing?

[David Cramer]

We will be making these changes next week.

Our current plan is to silently fail when you pass invalid/incorrect
parameters when we can (unless you have strict=1 in your params). This
means things like listPopular may ignore your since param.

Cases where you're requesting data form multiple forums, authors, etc.
will create a hard failure.

[David Cramer]

The first change related to this will be going live within the next
couple of days for threads/listPopular.

- Deprecated the ``since`` param (and try to coerce it to the new
``interval``)
- Noop the ``authors`` param
- Noop the ``include`` param
- ``category`` will only allow one value
- ``forum`` will only allow one value
- The forum of ``category`` must match ``forum`` if both are specified

[David Cramer]

Just kidding about ``since`` :)

It's actually going to be noop as well, and interval will default to
7d.