Comprendre les requêtes API et le quota

Votre plan d'abonnement inclut un quota mensuel de requêtes. Cette page explique précisément ce qui compte comme une requête, quels endpoints sont gratuits et ce qui se passe lorsque vous atteignez votre limite.

Qu'est-ce qu'une requête ?

1 requête = 1 appel à un endpoint API facturable, quel que soit le contenu de la réponse.

Chaque appel réussi à un endpoint facturable compte pour exactement une requête déduite de votre quota. La taille de la réponse, le nombre d'éléments retournés, les paramètres de requête ou le code HTTP n'ont aucun effet sur le comptage — un appel qui retourne 1 000 fixtures et un appel qui retourne 0 fixture consomment tous deux exactement 1 requête.

Les requêtes sont comptées par abonnement, donc tous les appels effectués avec votre clé API s'additionnent sur le même quota.

Quels endpoints sont comptabilisés ?

Endpoints facturables (comptés dans votre quota)

Chaque appel à ces endpoints utilise 1 requête :

/v4/players
/v4/settlements
/v4/fixtures
/v4/fixture
/v4/odds-by-tournaments
/v4/languages
/v4/sports
/v4/bookmakers
/v4/markets
/v4/tournaments
/v4/participants
/v4/scores
/v4/odds

Endpoints gratuits (NON comptés dans votre quota)

/v4/historical-odds — toujours gratuit. Les appels n'incrémentent jamais votre compteur de requêtes.

Endpoints non mesurés (NON comptés et jamais bloqués)

/v4/account — toujours accessible, même après l'épuisement de votre quota. Cela garantit que vous pouvez toujours vérifier l'état de votre abonnement et le quota restant.

Quand une requête est-elle comptabilisée ?

Une requête est comptée une fois que l'endpoint a terminé son traitement, que la réponse ait été réussie ou qu'elle ait retourné une erreur. Cela inclut :

200 OK — réponses réussies
4xx — erreurs client (par exemple paramètres invalides, ressource introuvable)
5xx — erreurs serveur

Remarque

Les requêtes rejetées avant d'atteindre l'endpoint — par exemple parce que votre clé API est invalide ou que votre quota est déjà épuisé — ne sont pas comptabilisées.

Atteindre votre limite

Lorsque votre nombre cumulé de requêtes atteint la valeur request_limit de votre plan, tout appel ultérieur à un endpoint facturable ou gratuit (à l'exception de /v4/account) retournera immédiatement :

HTTP/1.1 429 Too Many Requests

{
  "message": "Request limit exceeded",
  "details": "You have exceeded your request limit of X requests.",
  "code": "REQUEST_LIMIT_EXCEEDED"
}

Vous pouvez continuer à appeler /v4/account à tout moment pour consulter votre abonnement, votre utilisation actuelle et la date de renouvellement de votre quota.

Vérifier votre utilisation

Appelez GET /v4/account à tout moment. La réponse contient, pour votre abonnement actif :

request_limit — le quota de votre plan
request_count — le nombre de requêtes facturables consommées sur la période en cours

Conseils pour limiter la consommation de requêtes

Mettez les réponses en cache côté client lorsque les données sous-jacentes changent peu (par exemple /v4/sports, /v4/bookmakers, /v4/markets, /v4/languages).
Regroupez dès que possible — utilisez /v4/fixtures avec des filtres plutôt que plusieurs appels individuels lorsque vous avez besoin de plusieurs fixtures à la fois.
Pollez raisonnablement — chaque interrogation d'un endpoint facturable consomme 1 requête, alignez donc votre intervalle de polling sur la fréquence réelle de changement des données.

Page précédenteOverview

Page suivanteGET account