Entendendo as requisições da API e a cota

Seu plano de assinatura inclui uma cota mensal de requisições. Esta página explica exatamente o que conta como uma requisição, quais endpoints são gratuitos e o que acontece quando você atinge seu limite.

O que é 1 requisição?

1 requisição = 1 chamada a um endpoint de API tarifado, independentemente da resposta.

Cada chamada bem-sucedida a um endpoint tarifado conta como exatamente uma requisição descontada da sua cota. O tamanho da resposta, o número de itens retornados, os parâmetros de consulta ou o status HTTP não afetam a contagem — uma chamada que retorna 1.000 fixtures e uma chamada que retorna 0 fixtures consomem ambas exatamente 1 requisição.

As requisições são contabilizadas por assinatura, portanto todas as chamadas feitas com sua chave API acumulam contra a mesma cota.

Quais endpoints contam?

Endpoints tarifados (contam para sua cota)

Cada chamada a estes endpoints consome 1 requisição:

/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 gratuitos (NÃO contam para sua cota)

/v4/historical-odds — sempre gratuito. As chamadas nunca incrementam o seu contador de requisições.

Endpoints não medidos (NÃO contam e nunca são bloqueados)

/v4/account — sempre acessível, mesmo após a cota estar esgotada. Isso garante que você sempre possa consultar o status da assinatura e a cota restante.

Quando uma requisição é contabilizada?

Uma requisição é contabilizada depois que o endpoint terminou o processamento, independentemente de a resposta ter sido bem-sucedida ou ter retornado um erro. Isso inclui:

200 OK — respostas bem-sucedidas
4xx — erros do cliente (por exemplo, parâmetros inválidos, recurso não encontrado)
5xx — erros do servidor

Observação

Requisições rejeitadas antes de chegarem ao endpoint — por exemplo, porque sua chave API é inválida ou sua cota já foi esgotada — não são contabilizadas.

Atingindo seu limite

Quando sua contagem acumulada atinge o valor request_limit do seu plano, toda chamada subsequente a um endpoint tarifado ou gratuito (exceto /v4/account) retornará imediatamente:

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"
}

Você pode continuar chamando /v4/account a qualquer momento para verificar sua assinatura, o uso atual e quando sua cota é reiniciada.

Consultando seu uso

Chame GET /v4/account a qualquer momento. A resposta inclui, para sua assinatura ativa:

request_limit — a cota do seu plano
request_count — quantas requisições tarifadas você consumiu no período atual

Dicas para minimizar o consumo de requisições

Armazene as respostas em cache no cliente quando os dados subjacentes mudam raramente (por exemplo, /v4/sports, /v4/bookmakers, /v4/markets, /v4/languages).
Agrupe sempre que possível — use /v4/fixtures com filtros em vez de várias chamadas individuais quando precisar de várias fixtures de uma vez.
Faça polling com responsabilidade — cada polling em um endpoint tarifado é 1 requisição, então alinhe o intervalo com a frequência real de mudança dos dados.

Página anteriorOverview

Próxima páginaGET account