Límits de taxa i quotes

Per assegurar un ús equitatiu i mantenir un rendiment òptim per a tots els consumidors de l'API sanitària, l'API de vitalera aplica límits de taxa a tots els punts d'accés. Aquests límits estan dissenyats per admetre fluxos de dades de monitorització remota de pacients d'alta freqüència alhora que protegeixen la disponibilitat del servei per a totes les organitzacions.

Límits de taxa

Categoria de punt d'accés	Límit	Finestra
Crides generals a l'API	1000 peticions per hora	Per hora
Autenticació	100 peticions per minut	Per minut
Recuperació de dades	500 peticions per hora	Per hora

Capçaleres

La informació sobre límits de taxa s'inclou a les capçaleres de la resposta:

• X-RateLimit-Limit: El nombre màxim de peticions permeses a la finestra actual.
• X-RateLimit-Remaining: El nombre de peticions restants a la finestra actual.
• X-RateLimit-Reset: L'hora en què es restableix la finestra actual del límit de taxa en segons epoch UTC.

Gestió de límits de taxa

• Monitoritzeu les capçaleres: Comproveu sempre les capçaleres de límit de taxa per gestionar la vostra freqüència de peticions.
• Implementeu lògica de reintent: Utilitzeu reintent exponencial quan torneu a intentar peticions després d'assolir els límits de taxa.
• Optimitzeu les peticions: Agrupeu peticions quan sigui possible per minimitzar el nombre de crides a l'API.

Excés de límits de taxa

Si supereu els límits de taxa, l'API respondrà amb un codi d'estat 429 Too Many Requests. Hauríeu de gestionar-ho correctament implementant mecanismes de reintent.

Exemple de resposta:

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