Limitations

Pyyntömäärän rajoittaminen

Fenerum API käyttää pyyntömäärän rajoittamista varmistakseen tasapuolisen käytön ja säilyttääkseen palvelun laadun kaikille käyttäjille.

Pyyntömäärän rajoitukset

Oletusrajoitus on 60 pyyntöä minuutissa per API-käyttäjä.

Rajoitukset voivat vaihdella sopimuksesi mukaan:

• Oletus: 60 pyyntöä minuutissa
• Mukautettu: Korkeampia rajoja saatavilla pyynnöstä

Rate limit -otsakkeet

Kun ylität rajoituksen, saat vastauksen 429 Too Many Requests, jossa on Retry-After-otsake:

HTTP/1.1 429 Too Many Requests
Retry-After: 42

Vastausrungossa on lisätietoja rajoittamisesta:

{
  "detail": "Request was throttled. Expected available in 42 seconds."
}

Parhaat käytännöt

1. Noudata Retry-After-otsaketta

Kun saat 429-vastauksen, käytä Retry-After-otsakkeen arvoa ja lisää pieni marginaali:

import time

def make_request_with_retry(url, max_retries=3):
    for attempt in range(max_retries):
        response = requests.get(url, headers=headers)

        if response.status_code != 429:
            return response

        # Use Retry-After header value + 1 second buffer
        retry_after = int(response.headers.get('Retry-After', 60))
        time.sleep(retry_after + 1)

    return response

2. Erätoiminnot

Käytä mahdollisuuksien mukaan batch-endpointteja vähentääksesi pyyntöjen määrää:

• Luo useita luonnoslaskurivejä yhdessä pyynnössä
• Käytä suodatusta hakeaksesi vain tarvittavat tiedot

3. Välimuistita vastaukset

Tallenna API:n vastaukset välimuistiin, kun data ei muutu usein:

• Organisaation asetukset
• Plan-määrittelyt
• Tuoteluettelot

Tarvitsetko korkeammat rajat?

Ota yhteyttä tukeemme, jos tarvitset integraatiollesi korkeampia rajoja.