Die Core-API von Measurabl hat eine Ratenbegrenzung. Dies ist ein Mechanismus, der die Anzahl der API-Aufrufe eines API-Benutzers innerhalb eines bestimmten Zeitraums begrenzt. Wird die Ratenbegrenzung überschritten (d. h. zu viele Anfragen in zu kurzer Zeit gestellt), wird dem Benutzer eine Fehlermeldung angezeigt, dass die Ratenbegrenzung erreicht wurde und er warten muss, bis er weitere Anfragen stellen kann.
Measurabl hat für alle API-Endpunkte eine Ratenbegrenzung, wie in der folgenden Tabelle angegeben. Dabei gilt für die Anfragen immer ein Zeitraum von 5 Minuten. Für verschiedene Methoden und Endpunkte können verschiedene Ratenbegrenzungen gelten.
| Anfragetyp | Beschreibung | Anzahl Anfragen | Zeitraum |
| Nicht authentifiziert | Bei nicht authentifizierten Anfragen wird kein gültiges Authentifizierungstoken mitgesendet. | 50 | /5 Min. |
| Authentifizierte POST/PATCH/DELETE-Anfragen | Für alle Endpunkte, die nicht als HIGH FREQUENCY gekennzeichnet sind | 25 | /5 Min. |
| Authentifizierte HIGH FREQUENCY/POST/PATCH/DELETE-Anfragen | Für folgende Endpunkte:
|
100 | /5 Min. |
| Authentifizierte GET-Anfragen | Für alle Endpunkte | 225 | /5 Min. |
| Neues Authentifizierungstoken generieren | Ein Authentifizierungstoken bleibt 24 Stunden gültig. In den meisten Fällen ist nur eine Anfrage pro Tag erforderlich. | 25 | /5 Min. |
Wie können Nutzer den Status ihrer Ratenbegrenzung sehen?
Die Details zur Ratenbegrenzung werden in den HTTP-Headern der Antwort angegeben. Wenn die Ratenbegrenzung erreicht wurde, wird die Meldung „429: Too Many Requests“ empfangen. Einzelheiten zur Ratenbegrenzung erscheinen wie folgt in den HTTP-Headern der Antwort:
'X-RateLimit-Limit' => 25 # die Ratenbegrenzung für den jeweiligen Endpunkt
'X-RateLimit-Remaining' => '0'
'X-RateLimit-Reset' => '2022-10-13T04:08:00.328125Z' # wann die Ratenbegrenzung für diesen Endpunkt aufgehoben wird
'Retry-After' => 60 # seconds
| Beschreibung | |
| X-RateLimit-Limit | Die maximale Anzahl an Anfragen, die der Benutzer innerhalb von 5 Minuten stellen darf. |
| X-RateLimit-Remaining | Die verbleibende Anzahl an Anfragen im aktuellen Zeitfenster. Der Wert kann negativ sein, wenn die Begrenzung überschritten wurde. |
| X-RateLimit-Reset | Der Zeitpunkt, zu dem das aktuelle Zeitfenster für die Ratenbegrenzung zurückgesetzt wird, in Unixzeit. |
| Retry-After | Wie lange der Nutzer bis zur nächsten Anfrage warten muss. |