Rate limit docs

[rcmarron]

Changes

We're adding some rate limits to the API, this PR documents them

Checklist

• [ ] Titles are in sentence case
• [ ] Feature names are in sentence case too
• [ ] Words are spelled using American English
• [ ] I have checked out our style guide

[camerondeleone]

@rcmarron Could we clarify how exactly we enforce these (per personal key / per org / per IP/requester)?

[rcmarron]

@rcmarron Could we clarify how exactly we enforce these (per personal key / per org / per IP/requester)?

Really good point - just updated the docs to reflect that it's on a per-team basis (and updated the code to be the same)

[camerondeleone]

Another random thought I'll drop here - would probably be good in the API docs themselves to explicitly call out what the rate limit is per-endpoint, because people on cloud shouldn't really need to know what hits clickhouse vs postgres (maybe one for you @pjhul )

[timgl]

@pauldambra I'm getting these errors locally after hitting the @me endpoint changing settings a handful of times. I don't think we should enforce these limits that hard when you're using the interface (ie not through an api token)