Comprender las solicitudes API y la cuota

Tu plan de suscripción incluye una asignación mensual de solicitudes. Esta página explica exactamente qué cuenta como solicitud, qué endpoints son gratuitos y qué ocurre cuando alcanzas tu límite.

¿Qué es 1 solicitud?

1 solicitud = 1 llamada a un endpoint API facturable, independientemente de la respuesta.

Cada llamada exitosa a un endpoint facturable cuenta como exactamente una solicitud descontada de tu cuota. El tamaño de la respuesta, el número de elementos devueltos, los parámetros de consulta o el estado HTTP no afectan al recuento — una llamada que devuelve 1.000 fixtures y una llamada que devuelve 0 fixtures consumen exactamente 1 solicitud cada una.

Las solicitudes se cuentan por suscripción, por lo que todas las llamadas realizadas con tu clave API se acumulan contra la misma asignación.

¿Qué endpoints cuentan?

Endpoints facturables (cuentan para tu cuota)

Cada llamada a estos endpoints consume 1 solicitud:

/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 (NO cuentan para tu cuota)

/v4/historical-odds — siempre gratuito. Las llamadas nunca incrementan tu contador de solicitudes.

Endpoints no medidos (NO cuentan y nunca se bloquean)

/v4/account — siempre accesible, incluso después de agotar tu cuota. Esto garantiza que siempre puedas consultar el estado de tu suscripción y la cuota restante.

¿Cuándo se cuenta una solicitud?

Una solicitud se cuenta una vez que el endpoint ha terminado de procesar, tanto si la respuesta fue exitosa como si devolvió un error. Esto incluye:

200 OK — respuestas exitosas
4xx — errores del cliente (por ejemplo parámetros inválidos, recurso no encontrado)
5xx — errores del servidor

Nota

Las solicitudes rechazadas antes de llegar al endpoint — por ejemplo porque tu clave API no es válida o tu cuota ya está agotada — no se contabilizan.

Al alcanzar tu límite

Cuando tu número acumulado de solicitudes alcanza el valor request_limit de tu plan, toda llamada posterior a un endpoint facturable o gratuito (excepto /v4/account) devolverá inmediatamente:

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

Puedes seguir llamando a /v4/account en cualquier momento para consultar tu suscripción, tu uso actual y cuándo se renueva tu cuota.

Consultar tu uso

Llama a GET /v4/account en cualquier momento. La respuesta incluye, para tu suscripción activa:

request_limit — la asignación de tu plan
request_count — cuántas solicitudes facturables has consumido en el periodo actual

Consejos para reducir el consumo de solicitudes

Almacena en caché las respuestas en el cliente cuando los datos subyacentes cambien con poca frecuencia (por ejemplo /v4/sports, /v4/bookmakers, /v4/markets, /v4/languages).
Agrupa cuando sea posible — usa /v4/fixtures con filtros en lugar de muchas llamadas a fixtures individuales cuando necesites varios fixtures a la vez.
Sondea de forma razonable — cada sondeo a un endpoint facturable es 1 solicitud, así que alinea tu intervalo de polling con la frecuencia con la que los datos realmente cambian.

Página anteriorOverview

Página siguienteGET account