forked from mirrors/pronouns.cc
2.2 KiB
2.2 KiB
Rate limits
The API has rate limits, generally separated by groups of endpoints. If you exceed a rate limit, the API will start to return 429 errors.
Headers
X-RateLimit-Bucket
: the bucket the rate limit is for (listed below)X-RateLimit-Limit
: the total number of requests you can make per minuteX-RateLimit-Remaining
: the number of requests remaining in the current timeframeX-RateLimit-Reset
: the unix timestamp that the number of requests resets atRetry-After
: only if you hit a rate limit, the number of seconds until you can make requests again
Buckets
Note that only the most specific matching bucket is used for rate limits.
Bucket | Rate limit per minute | Notes |
---|---|---|
/ | 120 | Used as fallback if no other bucket exists for the endpoint |
GET /users/* | 60 | |
GET /users/*/members | 60 | |
GET /users/*/members/* | 60 | |
PATCH /users/@me | 10 | |
POST /members | 10 | |
GET /members/* | 60 | |
PATCH /members/* | 20 | |
DELETE /members/* | 5 | |
/auth/* | 20 | |
/auth/tokens | 10 | |
/auth/invites | 10 |