feat: add pagination support

[JGAntunes]

Based on our docs and a couple of expriments I did (and on bitballoon's codebase) we support pagination for all of our list endpoints but it's missing from our open-api spec.

This PR updates our open-api spec and respective golang client. It also addresses #277 and serves as a base to address netlify/js-client#39, netlify/js-client#44 and netlify/js-client#167.

Let me know what you think 👍

[netlify]

✔️ Deploy preview for open-api ready!

🔨 Explore the source changes: 9f301e0

🔍 Inspect the deploy logs: https://app.netlify.com/sites/open-api/deploys/5ff843c8a684830007e9091e

😎 Browse the preview: https://deploy-preview-278--open-api.netlify.app

[ehmicky]

Awesome! 🎉 🎉 🎉

This looks good to me, but I don't have a good understanding of the API pagination, unlike @vbrown608.

[rstavchansky]

Output looks good for docs! 🥇

[vbrown608]

Only those controllers that handle pagination_options and set pagination_headers support pagination. listAccountTypesForUser (AccountsController#types) does not, for example.

We're in the process of migrating our API docs to be built from inline annotations in the API codebase, so it might be better to add pagination to swagger as needed here, or just to endpoints where it seems most valuable to users of the SDK.

[vbrown608]

I suggest we start with following actions, which all support pagination, and are likely to include 100+ records for some users.
listSites
listSiteSubmissions
listSiteDeploys
listSiteBuilds
listFormSubmissions
listAccountAuditEvents

Thanks for working on this!

[JGAntunes]

Thanks for the review 👍 and thanks for checking this @vbrown608! I'll add this to those specific endpoints in that case. However, should we keep listSitesForAccount also? It's an endpoint that supports pagination and seems to be likely to have 100+ records.

[JGAntunes]

Meanwhile I've updated the spec but kept listSitesForAccount, let me know if it makes sense to remove that also. 👍

[vbrown608]

Nice catch! Yeah, let's definitely keep that one too. This looks good to me.