Afspraken
Limieten en quota
Limieten gelden per token. Elk antwoord zegt waar je staat, zodat je kunt vertragen voordat je tegen een 429 aanloopt.
De getallen
| Limiet | Waarde |
|---|---|
| Verzoeken per minuut, per token | 120 |
| Verzoeken per dag, per token (standaard) | 10.000 |
| Items per pagina | standaard 25, hoogstens 100 |
| OAuth: registraties per adres | 30 per 10 minuten |
| OAuth: registraties voor het hele platform | 1.000 per uur |
| OAuth: tokenverzoeken per adres | 120 per minuut |
De headers
| Header | Betekenis |
|---|---|
X-Request-Id | Id of this request, quote it in a support mail. |
X-RateLimit-Limit | Requests allowed per minute for this token. |
X-RateLimit-Remaining | Requests left in the current minute. |
X-RateLimit-Reset | Unix seconds at which the minute window resets. |
Retry-After | Bij een 429: hoeveel seconden je wacht. |
Over de limiet? Dan krijg je 429 rate_limited met Retry-After in seconden. Bij het dagbudget is dat de tijd tot middernacht in Amsterdam, waar het budget opnieuw begint.
Cachen en ETag
Openbare antwoorden (de agenda) zijn voor iedereen gelijk en hebben een ETag en een Cache-Control met max-age. Stuur de ETag terug in If-None-Match; is er niets veranderd, dan krijg je 304 zonder body. Antwoorden over je eigen organisatie of je token zijn private, no-store.
curl -s -i "https://api.partyppl.nl/v1/genres" \
-H "Authorization: Bearer $PPL_TOKEN" \
-H 'If-None-Match: "<etag>"'Meer tokens maken om de limieten te omzeilen mag niet. Heb je echt meer nodig, mail dan api@partyppl.nl: het dagbudget kan per token omhoog.
Bijgewerkt