Kyselynopeusrajoitukset

Kyselynopeusrajoitukset ovat järjestelmän määrittelemiä rajoituksia, joiden mukaan asiakas tai käyttäjä voi suorittaa kyselyitä tai pyyntöjä tietyssä ajassa. Näiden rajoitusten tarkoituksena on suojata palvelinta, varmistaa resurssien oikeudenmukainen jakaminen sekä ylläpitää palvelun suorituskykyä ja saatavuutta.

Rajoituksia voidaan kohdentaa per käyttäjä tai API-avain, IP-osoite, tietty päätepiste tai näiden yhdistelmä. Yleisiä malleja ovat kiinteä ikkuna (fixed window), liukuva ikkuna (sliding window) sekä tilakantimen menetelmät kuten token bucket ja leaky bucket. Näin voidaan hallita sekä jatkuvaa kuormitusta että sallia lyhyet piikit.

Kun rajoitus ylittyy, vastauksessa palautuu tyypillisesti virhe 429 Too Many Requests. Palvelu saattaa tarjota lisätietoja käytettävissä olevista rajoituksista vastauksissa otsikoiden muodossa, kuten X-RateLimit-Limit, X-RateLimit-Remaining ja X-RateLimit-Reset, tai vastaavilla nimikkeillä. Joissakin tapauksissa käytetään myös Retry-After-otsikkoa. Rajoitusten tiedottaminen auttaa sovelluksia sopeutumaan ja välttämään turhia virheitä.

Käytännön hallintaa kyselynopeusrajoituksilla harjoittavat sekä palvelun ylläpitäjät että asiakkaat. Ylläpito tavoittelee palvelun vakauden ja oikeudenmukaisen käytön, kun taas asiakkaat voivat sopeuttaa toimintaansa käyttämällä takaisinottoa (backoff) ja mahdollisesti porrasta, puskurointia, kyselyjen yhteen- ja uudelleenkäyttöä sekä sisällön välimuistia. Hyvä suunnittelu huomioi läpinäkyvyyden, oikeat mittarit ja muutosvalmiuden skaalautuvuuteen.