Rate Limiting

Fonctionnement

Chaque cle API dispose d’une limite de requetes par heure (par defaut : 1000 requetes/heure). Cette limite est configurable par l’administrateur de la clinique lors de la creation de la cle.

Le compteur utilise une fenetre glissante : chaque requete est comptabilisee pendant 1 heure a partir de son execution.

Header	Description
`X-RateLimit-Limit`	Nombre maximum de requetes par heure
`X-RateLimit-Remaining`	Requetes restantes dans la fenetre courante

Header

Description

X-RateLimit-Limit

Nombre maximum de requetes par heure

X-RateLimit-Remaining

Requetes restantes dans la fenetre courante

Depassement de limite

Lorsque la limite est atteinte, l’API retourne une erreur 429 Too Many Requests :

// 429 Too Many Requests
{
  "message": "Rate limit exceeded. Please try again later.",
  "retryAfter": 42
}

Le header Retry-After indique le nombre de secondes a attendre avant de pouvoir refaire une requete.

HTTP/1.1 429 Too Many Requests
Retry-After: 42
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0

Bonnes pratiques

Implementez un backoff exponentiel

En cas de 429, attendez le temps indique par Retry-After, puis reessayez. Si ca echoue encore, doublez le delai a chaque tentative.

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('Retry-After') || '60');
      const delay = retryAfter * 1000 * Math.pow(2, i);
      await new Promise(r => setTimeout(r, delay));
      continue;
    }

    return response;
  }
  throw new Error('Rate limit exceeded after retries');
}

Mettez en cache les donnees stables

Les informations comme les types de rendez-vous ou les fiches patients changent rarement. Mettez-les en cache localement pour reduire le nombre d’appels.

Surveillez votre consommation

Loggez les headers X-RateLimit-Remaining pour anticiper les depassements et ajuster votre rythme d’appels.

Demandez une augmentation si necessaire

Si votre integration necessite plus de requetes, contactez l’administrateur de la clinique pour augmenter la limite sur votre cle.

Pour commencer

Cas d'usage

Fonctionnement

Headers de reponse

Depassement de limite

Bonnes pratiques

​Fonctionnement

​Headers de reponse

​Depassement de limite

​Bonnes pratiques

Fonctionnement

Headers de reponse

Depassement de limite

Bonnes pratiques