Limits und Kontingente
Was Ihr Plan erlaubt, wie jede Antwort sagt, wie viel übrig ist, und was am Limit passiert.
Ihr Plan legt fest, wie viel Sie lesen können. Die Zahlen je Plan stehen auf der Preisseite; /plan
liefert Ihre, mit der Nutzung in diesem Monat:
curl -H "Authorization: Bearer $PRICANA_KEY" https://pricana.io/api/v1/planDie Limits
| Limit | Was es begrenzt | Am Limit |
|---|---|---|
ratePerSecond | Anfragen pro Sekunde | 429, Retry-After |
apiCallsPerMonth | Calls mit API-Keys je Kalendermonat (UTC) | 429 bis zum 1., oder berechnet (Overage) |
exportRowsPerMonth | von Exporten geschriebene Zeilen pro Monat | der Export endet am Limit, oder berechnet (Overage) |
datasets | wie viele Ihrer Datasets Sie lesen können | die übrigen antworten mit 402 |
historyDays | wie weit Historie und Change-Feed zurückreichen | ältere Einträge werden nicht angezeigt |
delayHours | Daten mit dem Stand von vor so vielen Stunden (Free: 24) | – |
changeFeed | /changes | 402 |
webhooks | Webhooks | 402, pausiert |
users | Personen in Ihrem Team (offene Einladungen zählen mit) | 402 |
null heißt unbegrenzt. Calls im Portal (angemeldet, im Browser) zählen nicht gegen apiCallsPerMonth.
Header in jeder Antwort
| Header | |
|---|---|
RateLimit-Limit | Anfragen pro Sekunde |
RateLimit-Remaining | in dieser Sekunde übrige Anfragen |
RateLimit-Reset | Sekunden, bis es sich wieder auffüllt |
X-Quota-Limit | Calls pro Monat |
X-Quota-Remaining | in diesem Monat übrige Calls |
X-Quota-Reset | Sekunden, bis der Monat neu beginnt |
X-Quota-Overage | true: Dieser Call liegt über dem Kontingent und wird berechnet |
Behalten Sie X-Quota-Remaining im Blick, um rechtzeitig langsamer zu werden. Das Portal zeigt die Nutzung des Monats
als Balken, und Owner, Admins und Billing-Mitglieder Ihres Teams bekommen bei 80 % und bei 100 % eine E-Mail (abschaltbar
im Portal unter Settings).
Overage
In bezahlten Plänen schlagen Calls und Exportzeilen über dem Monatskontingent nicht fehl: Sie werden am Monatsende
berechnet, je 1.000 Calls und je 10.000 Zeilen (X-Quota-Overage: true, X-Export-Overage: true), wie es auf der
Preisseite steht. In der Testphase gibt es kein Overage: Calls über dem Kontingent bekommen 429, und
Exporte enden am Limit.
Lieber eine feste Grenze? Schreiben Sie uns, und wir schalten Overage für Ihr Konto ab: Dann endet
Ihr Plan an seinen Kontingenten wie Free (429, Exporte enden am Limit), und darüber hinaus wird nichts berechnet.
So schonen Sie Ihre Limits
- Lesen Sie Seiten mit bis zu 500 Items statt einzelner Items; für alles auf einmal nutzen Sie Exporte.
- Synchronisieren Sie mit dem Change-Feed oder mit Webhooks, statt alle Items neu zu lesen.
- Bei
429warten SieRetry-AfterSekunden. Bei5xxversuchen Sie es mit wachsenden Pausen erneut.