Rate-limiting en throttling in de ReflexBlue Externe API
De meeste eindpunten van de ReflexBlue Externe API zijn voorzien van rate-limiting (ook wel throttling genoemd). Dit betekent dat je binnen een bepaalde tijd maar een beperkt aantal verzoeken mag sturen naar deze eindpunten. Externe systemen moeten hier rekening mee houden en verzoeken tijdelijk uitstellen als het limiet is bereikt.
Overschrijden van het limiet
Als je het limiet overschrijdt, geeft de ReflexBlue Applicatie Server een HTTP-statuscode 429 (Too Many Requests) terug bij het doen van een verzoek naar de Externe API. In de response vind je de HTTP-header retry-after. Deze header geeft aan hoeveel milliseconden je moet wachten voordat je weer een nieuw verzoek mag doen.
Het externe systeem kan de verwerking dan tijdelijk pauzeren. Zodra de opgegeven tijd is verstreken, kan je opnieuw een verzoek sturen.
Toegestane aantal verzoeken
Meestal mag je tot 60 verzoeken per minuut sturen naar de ReflexBlue Applicatie Server via de Externe API. Dit aantal kan echter verschillen per API-eindpunt en is afhankelijk van andere factoren. Controleer daarom altijd de documentatie van het specifieke eindpunt voor de actuele limieten.
Uitzonderingen op rate-limiting
Bepaalde API-eindpunten zijn uitgezonderd van rate-limiting. Kijk in de documentatie van het betreffende eindpunt of rate-limiting van toepassing is.