Limits
How much one API key can do at once, and how big a request and its pages can be.
Rate limits
Each key can make 60 requests a minute and have up to 4 changes in progress at once. The minute is a fixed one on the clock, not a rolling window.
Past either limit, the API answers 429 with a Retry-After header giving the seconds to wait:
detail |
Retry-After |
|---|---|
too many requests |
The seconds left in the current minute (1 to 60). |
too many changes in progress |
2 |
If GrowLocal can't check the limits at that moment it answers 503 (external access is not available) rather than letting the call through; wait and try again. Neither answer runs anything, so the same request can be sent again as it is.
Sizes
| What | Limit |
|---|---|
| A request body | 64 KB, as application/json |
operationId |
80 characters |
| A page of the catalogue | 100 entries |
| A page of rows (Read a list) | 1 to 200 rows (pageSize) |
| Filters in one query | 16 |
| Sort keys in one query | 3 |
| Search text | 200 characters |
Keys
A key lives 7, 30 or 90 days, as chosen when it's made; 90 days is the longest (Make an API key). A catalogue cursor lasts 15 minutes; a row cursor doesn't expire.