Add Pagination to the API

[polilluminato]

Hi everyone, I think it could be a nice idea to add in the API section an endpoint to retrieve the shows list in paginated format, something like limit and offset in SQL. I propose this change because it would be very useful in case you want to implement a list with the contents that load on a scroll and an endpoint that returns the paginated results would be very useful.

Based on the current API structure, the endpoint could look like this:

https://syntax.fm/api/shows/paginated-[offset]-[limit]

or

https://syntax.fm/api/shows/paginated?offset=[offset]&limit=[limit]

I am developing a Flutter app for a side-project that shows the list of episodes and this feature could be very useful.

[wesbos]

Lets mirror the params from the shows page, that way we can re-use the queries:

page=2&perPage=20&order=asc&type=hasty

Let's limit perPage to 100

Another item is that modifying this API might break some apps, but it doesnt seem to have a TON of usage: https://github.com/search?q=syntax.fm%2Fapi&type=code

This API endpoint is getting too large and using a ton of bandwidth (thx vercel)

so, rather than versioning the API, I say we to 20 episodes per page and then try notify anyone who might be using it.