Skip to main content

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. 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 risponde 429 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.
Aspetta i secondi di Retry-After, poi ripeti. Per non arrivarci, rallenta quando X-RateLimit-Remaining si avvicina a zero.
Per ripetere una creazione dopo un 429, usa la stessa Idempotency-Key.