Naar hoofdinhoud gaan

Frequentielimieten en quota's

Om eerlijk gebruik te waarborgen en optimale prestaties voor alle gezondheidszorg-API-gebruikers te behouden, hanteert de vitalera API frequentielimieten op alle eindpunten. Deze limieten zijn ontworpen om hoogfrequente gegevensstromen voor monitoring van patienten op afstand te ondersteunen en tegelijkertijd de servicebeschikbaarheid voor alle organisaties te beschermen.

Frequentielimieten​

EndpointcategorieLimietTijdvenster
Algemene API-oproepen1000 verzoeken per uurPer uur
Authenticatie100 verzoeken per minuutPer minuut
Gegevensopvraging500 verzoeken per uurPer uur

Headers​

Informatie over frequentielimieten is opgenomen in de responsheaders:

  • X-RateLimit-Limit: Het maximale aantal toegestane verzoeken in het huidige tijdvenster.
  • X-RateLimit-Remaining: Het aantal resterende verzoeken in het huidige tijdvenster.
  • X-RateLimit-Reset: Het tijdstip waarop het huidige frequentielimietvenster wordt gereset in UTC-epoch-seconden.

Omgaan met frequentielimieten​

  • Headers monitoren: Controleer altijd de frequentielimietheaders om uw verzoekfrequentie te beheren.
  • Herhalingslogica implementeren: Gebruik exponential backoff bij het opnieuw verzenden van verzoeken na het bereiken van frequentielimieten.
  • Verzoeken optimaliseren: Bundel verzoeken waar mogelijk om het aantal API-oproepen te minimaliseren.

Overschrijding van frequentielimieten​

Als u de frequentielimieten overschrijdt, antwoordt de API met statuscode 429 Too Many Requests. U dient dit elegant af te handelen door herhalingsmechanismen te implementeren.

Voorbeeldantwoord:

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