Limiti
Il giorno è il giorno di calendario UTC: riparte a mezzanotte UTC. Una richiesta respinta con
429 non consuma il limite.
Il tetto per chiave impedisce a un solo programma di consumare tutto il limite della clinica: due programmi collegati con chiavi diverse non si fermano a vicenda.
Header
Ogni risposta a una richiesta con una chiave valida, errori compresi, porta questi header:
Una richiesta senza chiave o con una chiave sconosciuta non riceve gli header
X-RateLimit-*. Ogni risposta porta invece X-Request-Id.
Risposta 429
Oltre il limite l’API risponde429 rate_limited. In details: limit è il tetto che ha fermato la richiesta, window quale finestra (10s o day), scope di chi è il limite (organization per la clinica, api_key per la chiave), resetAt quando riparte, in ISO 8601.
Retry-After, poi ripeti. Per non arrivarci, rallenta quando X-RateLimit-Remaining si avvicina a zero.