Zum Hauptinhalt springen

Ratenbegrenzungen und Kontingente

Um eine faire Nutzung zu gewaehrleisten und eine optimale Leistung fuer alle Gesundheits-API-Verbraucher aufrechtzuerhalten, erzwingt die vitalera API Ratenbegrenzungen fuer alle Endpunkte. Diese Limits sind darauf ausgelegt, hochfrequente Datenfluesse fuer Fernpatientenueberwachung zu unterstuetzen und gleichzeitig die Serviceverfuegbarkeit fuer alle Organisationen zu schuetzen.

Ratenbegrenzungen​

EndpunktkategorieLimitZeitfenster
Allgemeine API-Aufrufe1000 Anfragen pro StundePro Stunde
Authentifizierung100 Anfragen pro MinutePro Minute
Datenabruf500 Anfragen pro StundePro Stunde

Headers​

Informationen zur Ratenbegrenzung sind in den Antwort-Headern enthalten:

  • X-RateLimit-Limit: Die maximale Anzahl erlaubter Anfragen im aktuellen Zeitfenster.
  • X-RateLimit-Remaining: Die Anzahl verbleibender Anfragen im aktuellen Zeitfenster.
  • X-RateLimit-Reset: Der Zeitpunkt, zu dem das aktuelle Ratenbegrenzungsfenster in UTC-Epoch-Sekunden zurueckgesetzt wird.

Handhabung von Ratenbegrenzungen​

  • Headers ueberwachen: Pruefen Sie immer die Ratenbegrenzungs-Headers, um Ihre Anfragerate zu steuern.
  • Wiederholungslogik implementieren: Verwenden Sie exponentielles Backoff beim erneuten Senden von Anfragen nach Erreichen der Ratenbegrenzung.
  • Anfragen optimieren: Fassen Sie Anfragen zusammen, wo moeglich, um die Anzahl der API-Aufrufe zu minimieren.

Ueberschreitung der Ratenbegrenzungen​

Wenn Sie die Ratenbegrenzungen ueberschreiten, antwortet die API mit dem Statuscode 429 Too Many Requests. Sie sollten dies elegant handhaben, indem Sie Wiederholungsmechanismen implementieren.

Beispielantwort:

{
  "type": "client_error",
  "errors": [
    {
      "code": "rate_limit_exceeded",
      "detail": "You have exceeded the rate limit. Please try again later.",
      "attr": null
    }
  ]
}