Guía de integración API keys GET 14 endpoints Solo lectura
URL base https://api.sportwey.com/external/v1La URL base de la API es https://api.sportwey.com/external/v1. Usa una clave autorizada para este servicio; comprueba la disponibilidad con el administrador.
Tu primera integración 4 pasos 1 Crea una clave En API keys, selecciona Crear API key, asigna un nombre, elige los torneos y una vigencia de 7, 30, 90 o 365 días. Puedes tener hasta 3 claves activas y autorizar hasta 100 torneos por clave.
2 Guárdala en tu servidor La clave completa se muestra una sola vez. Guárdala en el gestor de secretos de tu aplicación. No la publiques en el navegador, una app distribuida, repositorios, logs, URLs ni conversaciones con IA.
3 Conecta y consulta Envía Authorization: Bearer TU_API_KEY por HTTPS. Consulta primero access o capabilities; después tournaments para obtener los identificadores autorizados. Usa esos IDs para calendario, resultados o posiciones.
4 Controla el acceso Consulta el consumo desde API keys. Puedes editar los torneos sin cambiar la clave ni su consumo y revocarla con un motivo. Los cambios pueden tardar en reflejarse. Una clave revocada no se puede recuperar.
Consultar tus torneos Tu integración solo puede consultar información. No puede crear, editar ni eliminar datos de los torneos.
Guía de integración API keys Cada integración utiliza una API key con acceso a los torneos que autoriza su administrador.
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Crea y guarda tu clave 1 Crea una clave En API keys, selecciona Crear API key, asigna un nombre, elige los torneos y una vigencia de 7, 30, 90 o 365 días. Puedes tener hasta 3 claves activas y autorizar hasta 100 torneos por clave.
2 Guárdala en tu servidor La clave completa se muestra una sola vez. Guárdala en el gestor de secretos de tu aplicación. No la publiques en el navegador, una app distribuida, repositorios, logs, URLs ni conversaciones con IA.
3 Controla el acceso Consulta el consumo desde API keys. Puedes editar los torneos sin cambiar la clave ni su consumo y revocarla con un motivo. Los cambios pueden tardar en reflejarse. Una clave revocada no se puede recuperar.
Comprueba el acceso Usa /access para revisar los permisos y el vencimiento. La respuesta no devuelve tu secreto.
Verificar acceso Guía de integración API keys Consulta solo la información que necesitas y recorre los resultados en páginas acotadas.
Fechas del calendario Calendario, resultados y resultados por equipo requieren from y to en formato YYYY-MM-DD, ambos incluidos, con máximo 93 fechas. Comparan fechas locales almacenadas; scheduled_at_local no incluye zona horaria. No lo interpretes como UTC. Equipos, jugadores, estadísticas individuales, detalle, posiciones, criterios y catálogos no aceptan from/to.
Continuar a la siguiente página Usa limit entre 1 y 100 (predeterminado 50). Calendario y listas de resultados incluyen pagination.limit, pagination.returned y pagination.has_more. Primera página: /tournaments/ID_DEL_TORNEO/calendar?from=2026-10-01&to=2026-10-31&limit=10. Para continuar añade &after=NEXT_CURSOR con el next_cursor exacto recibido. Conserva torneo, recurso, equipo y rango; detente cuando next_cursor sea null. No se inventan total de páginas ni saltos por page. Los criterios y catálogos son listas completas acotadas a 100 elementos y no aceptan parámetros de paginación.
?limit=10&after=NEXT_CURSOR
Si cambia la tabla En posiciones y estadísticas individuales, un 409 indica que los datos cambiaron durante la paginación. Reinicia desde la primera página una sola vez.
Ver calendario Guía de integración API keys Las claves de una misma cuenta comparten su cuota diaria.
Límites de consumo Configuración inicial: 10.000 peticiones admitidas al día por cuenta, compartidas entre sus claves. Por clave: ráfaga de 10, recuperación de 1 por segundo y 2 consultas simultáneas. La cuenta y el servicio también tienen límites compartidos. Son valores configurables por el operador. El reinicio diario es a las 00:00 UTC.
Cómo se cuentan las peticiones Una petición admitida reserva una unidad, aunque después termine en error. Las bloqueadas antes de admitirlas no consumen esa cuota. Un reintento nuevo puede consumir otra unidad. No hay datos de consumo global ni administración de claves en esta API externa.
Respuesta 429 Espera los segundos indicados en Retry-After. Acota los reintentos y no alternes claves para evadir los límites de la cuenta.
Guía de integración API keys Revisa el código de respuesta antes de reintentar una petición.
400 Parámetros inválidos Revisa las fechas, el límite y el cursor. Corrige la consulta antes de repetirla.
401 Clave no válida Comprueba el formato Bearer, el ambiente, el vencimiento y si la clave fue revocada.
403 / 404 Acceso no disponible Revisa que el torneo esté autorizado y que todavía lo administres. Posiciones puede estar oculta.
405 Método no permitido Todos los endpoints de datos aceptan únicamente GET.
409 Los datos cambiaron En posiciones o estadísticas individuales, reinicia desde la primera página una sola vez.
429 Límite alcanzado Respeta Retry-After, expresado en segundos. La cuota diaria se comparte entre todas tus claves.
503 Servicio no disponible No lo interpretes como un resultado vacío. Respeta Retry-After si aparece y limita los reintentos.
Para soporte, conserva el request_id si está disponible. Nunca compartas tu API key.
GET /accessv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Esta consulta no acepta parámetros de consulta.
Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.key_idstring Obligatorio data.scopesarray Obligatorio data.expires_atUnix timestamp in seconds.
integer Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error GET /capabilitiesv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Esta consulta no acepta parámetros de consulta.
Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.versionstring Obligatorio data.read_onlyboolean Obligatorio data.resourcesarray Obligatorio data.authenticationstring Obligatorio data.mcpobject Obligatorio data.mcp.availableboolean Obligatorio data.mcp.adapter_readyboolean Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Torneos y partidos API keys GET /tournamentsv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de consulta 2 limitinteger Opcional
Cantidad de elementos por página, entre 1 y 100. Predeterminado: 50.
afterstring Opcional
Cursor recibido en next_cursor. Omítelo en la primera página y conserva los demás filtros.
Paginación por cursor Consulta la primera página sin after. Continúa con el next_cursor recibido y conserva los filtros. Termina cuando el cursor sea null.
Ver fechas y paginación Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.itemsarray Obligatorio data.items[].idstring Obligatorio data.items[].namestring Obligatorio data.items[].seasonstring | integer | null Obligatorio data.next_cursorstring | null Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Torneos y partidos API keys GET /tournaments/{tournament_id}/calendarv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 1 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
Parámetros de consulta 4 fromstring Obligatorio
Fecha inicial incluida, en formato YYYY-MM-DD. Utiliza la fecha local del calendario.
tostring Obligatorio
Fecha final incluida, en formato YYYY-MM-DD. El rango admite hasta 93 fechas.
limitinteger Opcional
Cantidad de elementos por página, entre 1 y 100. Predeterminado: 50.
afterstring Opcional
Cursor recibido en next_cursor. Omítelo en la primera página y conserva los demás filtros.
Paginación por cursor Consulta la primera página sin after. Continúa con el next_cursor recibido y conserva los filtros. Termina cuando el cursor sea null.
Ver fechas y paginación Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.kind_competitorstring Obligatorio data.time_basisstring Obligatorio data.itemsarray Obligatorio data.items[].idstring Obligatorio data.items[].scheduled_at_localStored local wall-clock time; no timezone/UTC offset is supplied. Do not assume UTC.
string | null Obligatorio data.items[].statusstring Obligatorio data.items[].typestring Obligatorio data.items[].roundstring | integer | null Obligatorio data.items[].titlestring | null Obligatorio data.items[].groupstring | null Obligatorio data.items[].fieldstring | null Obligatorio data.items[].localobject | null Obligatorio data.items[].visitorobject | null Obligatorio data.items[].scoreobject | null Obligatorio data.next_cursorstring | null Obligatorio data.paginationobject Obligatorio data.pagination.limitinteger Obligatorio data.pagination.returnedinteger Obligatorio data.pagination.has_moreboolean Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Torneos y partidos API keys GET /tournaments/{tournament_id}/resultsv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 1 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
Parámetros de consulta 4 fromstring Obligatorio
Fecha inicial incluida, en formato YYYY-MM-DD. Utiliza la fecha local del calendario.
tostring Obligatorio
Fecha final incluida, en formato YYYY-MM-DD. El rango admite hasta 93 fechas.
limitinteger Opcional
Cantidad de elementos por página, entre 1 y 100. Predeterminado: 50.
afterstring Opcional
Cursor recibido en next_cursor. Omítelo en la primera página y conserva los demás filtros.
Paginación por cursor Consulta la primera página sin after. Continúa con el next_cursor recibido y conserva los filtros. Termina cuando el cursor sea null.
Ver fechas y paginación Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.kind_competitorstring Obligatorio data.time_basisstring Obligatorio data.itemsarray Obligatorio data.items[].idstring Obligatorio data.items[].scheduled_at_localStored local wall-clock time; no timezone/UTC offset is supplied. Do not assume UTC.
string | null Obligatorio data.items[].statusstring Obligatorio data.items[].typestring Obligatorio data.items[].roundstring | integer | null Obligatorio data.items[].titlestring | null Obligatorio data.items[].groupstring | null Obligatorio data.items[].fieldstring | null Obligatorio data.items[].localobject | null Obligatorio data.items[].visitorobject | null Obligatorio data.items[].scoreobject | null Obligatorio data.next_cursorstring | null Obligatorio data.paginationobject Obligatorio data.pagination.limitinteger Obligatorio data.pagination.returnedinteger Obligatorio data.pagination.has_moreboolean Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Torneos y partidos API keys GET /tournaments/{tournament_id}/matches/{match_id}v1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 2 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
match_idstring Obligatorio
ID de un partido devuelto por el calendario o los resultados de este torneo.
Esta consulta no acepta parámetros de consulta.
Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.kind_competitorstring Obligatorio data.time_basisstring Obligatorio data.matchobject Obligatorio data.match.idstring Obligatorio data.match.scheduled_at_localStored local wall-clock time; no timezone/UTC offset is supplied. Do not assume UTC.
string | null Obligatorio data.match.statusstring Obligatorio data.match.typestring Obligatorio data.match.roundstring | integer | null Obligatorio data.match.titlestring | null Obligatorio data.match.groupstring | null Obligatorio data.match.fieldstring | null Obligatorio data.match.localobject | null Obligatorio data.match.visitorobject | null Obligatorio data.match.scoreobject | null Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Equipos y jugadores API keys GET /tournaments/{tournament_id}/teamsv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 1 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
Parámetros de consulta 2 limitinteger Opcional
Cantidad de elementos por página, entre 1 y 100. Predeterminado: 50.
afterstring Opcional
Cursor recibido en next_cursor. Omítelo en la primera página y conserva los demás filtros.
Paginación por cursor Consulta la primera página sin after. Continúa con el next_cursor recibido y conserva los filtros. Termina cuando el cursor sea null.
Ver fechas y paginación Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.itemsarray Obligatorio data.items[].idstring Obligatorio data.items[].namestring Obligatorio data.next_cursorstring | null Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Equipos y jugadores API keys GET /tournaments/{tournament_id}/teams/{team_id}/playersv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 2 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
team_idstring Obligatorio
ID de un equipo devuelto por Equipos del torneo, dentro del mismo torneo autorizado.
Parámetros de consulta 2 limitinteger Opcional
Cantidad de elementos por página, entre 1 y 100. Predeterminado: 50.
afterstring Opcional
Cursor recibido en next_cursor. Omítelo en la primera página y conserva los demás filtros.
Paginación por cursor Consulta la primera página sin after. Continúa con el next_cursor recibido y conserva los filtros. Termina cuando el cursor sea null.
Ver fechas y paginación Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.teamstring Obligatorio data.itemsarray Obligatorio data.items[].namestring | null Obligatorio data.items[].last_namestring | null Obligatorio data.items[].imagePublic photo URL; null when no safe photo is available.
string | null Obligatorio data.next_cursorstring | null Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Equipos y jugadores API keys GET /tournaments/{tournament_id}/teams/{team_id}/resultsv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 2 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
team_idstring Obligatorio
ID de un equipo devuelto por Equipos del torneo, dentro del mismo torneo autorizado.
Parámetros de consulta 4 fromstring Obligatorio
Fecha inicial incluida, en formato YYYY-MM-DD. Utiliza la fecha local del calendario.
tostring Obligatorio
Fecha final incluida, en formato YYYY-MM-DD. El rango admite hasta 93 fechas.
limitinteger Opcional
Cantidad de elementos por página, entre 1 y 100. Predeterminado: 50.
afterstring Opcional
Cursor recibido en next_cursor. Omítelo en la primera página y conserva los demás filtros.
Paginación por cursor Consulta la primera página sin after. Continúa con el next_cursor recibido y conserva los filtros. Termina cuando el cursor sea null.
Ver fechas y paginación Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.kind_competitorstring Obligatorio data.time_basisstring Obligatorio data.itemsarray Obligatorio data.items[].idstring Obligatorio data.items[].scheduled_at_localStored local wall-clock time; no timezone/UTC offset is supplied. Do not assume UTC.
string | null Obligatorio data.items[].statusstring Obligatorio data.items[].typestring Obligatorio data.items[].roundstring | integer | null Obligatorio data.items[].titlestring | null Obligatorio data.items[].groupstring | null Obligatorio data.items[].fieldstring | null Obligatorio data.items[].localobject | null Obligatorio data.items[].visitorobject | null Obligatorio data.items[].scoreobject | null Obligatorio data.next_cursorstring | null Obligatorio data.paginationobject Obligatorio data.pagination.limitinteger Obligatorio data.pagination.returnedinteger Obligatorio data.pagination.has_moreboolean Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Posiciones y estadísticas API keys GET /tournaments/{tournament_id}/standingsv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 1 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
Parámetros de consulta 2 limitinteger Opcional
Cantidad de elementos por página, entre 1 y 100. Predeterminado: 50.
afterstring Opcional
Cursor recibido en next_cursor. Omítelo en la primera página y conserva los demás filtros.
Paginación por cursor Consulta la primera página sin after. Continúa con el next_cursor recibido y conserva los filtros. Termina cuando el cursor sea null.
Ver fechas y paginación Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.kind_competitorstring Obligatorio data.sourcestring Obligatorio data.snapshot_idstring Obligatorio data.generated_atFreshness timestamp unavailable; never infer live data.
null Obligatorio data.itemsarray Obligatorio data.items[].groupobject Obligatorio data.items[].group.indexinteger Obligatorio data.items[].group.namestring Obligatorio data.items[].positioninteger Obligatorio data.items[].competitorobject Obligatorio data.items[].competitor.idstring Obligatorio data.items[].competitor.namestring Obligatorio data.items[].statisticsarray Obligatorio data.items[].statistics[].idstring Obligatorio data.items[].statistics[].labelFull published statistic name, in Spanish.
string Obligatorio data.items[].statistics[].abbreviationConfigured short name; null if unavailable.
string | null Obligatorio data.items[].statistics[].valuenumber | null Obligatorio data.next_cursorstring | null Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Posiciones y estadísticas API keys GET /tournaments/{tournament_id}/standings/criteriav1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 1 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
Esta consulta no acepta parámetros de consulta.
Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.itemsarray Obligatorio data.items[].idstring Obligatorio data.items[].labelstring Obligatorio data.items[].priorityinteger Obligatorio data.items[].sourcestring Obligatorio data.base_pointsobject | null Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Posiciones y estadísticas API keys GET /tournaments/{tournament_id}/statistics/catalogv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 1 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
Esta consulta no acepta parámetros de consulta.
Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.itemsarray Obligatorio data.items[].idstring Obligatorio data.items[].labelFull published statistic name, in Spanish.
string Obligatorio data.items[].abbreviationConfigured short name; null if unavailable.
string | null Obligatorio data.items[].sourcestring Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Posiciones y estadísticas API keys GET /tournaments/{tournament_id}/players/statisticsv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 1 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
Parámetros de consulta 4 limitinteger Opcional
Cantidad de elementos por página, entre 1 y 100. Predeterminado: 50.
afterstring Opcional
Cursor recibido en next_cursor. Omítelo en la primera página y conserva los demás filtros.
sortstring Opcional
Ordena por name, last_name o un metrics.id publicado en la respuesta. No utilices el nombre ni la abreviación de la métrica.
orderstring Opcional
Dirección del orden: asc o desc. Consérvala al continuar con after.
ascdesc
Paginación por cursor Consulta la primera página sin after. Continúa con el next_cursor recibido y conserva los filtros. Termina cuando el cursor sea null.
Ver fechas y paginación Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.sourcestring Obligatorio data.snapshot_idstring Obligatorio data.generated_atnull Obligatorio data.metricsarray Obligatorio data.metrics[].idstring Obligatorio data.metrics[].labelFull published statistic name, in Spanish.
string Obligatorio data.metrics[].abbreviationConfigured short name; null if unavailable.
string | null Obligatorio data.sortstring Obligatorio data.orderstring Obligatorio data.totalinteger Obligatorio data.itemsarray Obligatorio data.items[].playerobject Obligatorio data.items[].player.namestring | null Obligatorio data.items[].player.last_namestring | null Obligatorio data.items[].player.imagePublic photo URL; null when no safe photo is available.
string | null Obligatorio data.items[].teamstring | null Obligatorio data.items[].statisticsarray Obligatorio data.items[].statistics[].idstring Obligatorio data.items[].statistics[].labelFull published statistic name, in Spanish.
string Obligatorio data.items[].statistics[].abbreviationConfigured short name; null if unavailable.
string | null Obligatorio data.items[].statistics[].valuenumber | null Obligatorio data.next_cursorstring | null Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Posiciones y estadísticas API keys GET /tournaments/{tournament_id}/players/statistics/catalogv1
Bearer API key Envía tu clave en el encabezado Authorization de cada petición por HTTPS.
Authorization: Bearer TU_API_KEY
Solo permite consultar los torneos autorizados. Conserva el secreto en tu servidor.
Parámetros de ruta 1 tournament_idstring Obligatorio
ID de un torneo devuelto por Torneos autorizados. Usa exactamente ese identificador.
Esta consulta no acepta parámetros de consulta.
Estructura de la respuesta 200 OK data contiene el resultado y request_id identifica la petición. null indica un valor no disponible.
Campo Tipo Presencia dataobject Obligatorio data.tournamentstring Obligatorio data.itemsarray Obligatorio data.items[].idstring Obligatorio data.items[].labelFull published statistic name, in Spanish.
string Obligatorio data.items[].abbreviationConfigured short name; null if unavailable.
string | null Obligatorio data.items[].sourcestring Obligatorio request_idstring Obligatorio
Errores y consumo Cada petición admitida consume una unidad, aunque después termine en error. Ante un 429, respeta Retry-After.
Consultar códigos de error Guía de integración API keys La especificación OpenAPI permite describir estas consultas como herramientas de un agente. Autoriza la clave en el gestor de credenciales de la herramienta; no pegues secretos en un prompt. MCP no está publicado: esta documentación prepara la interfaz para un adaptador futuro.
Importa la especificación OpenAPI en una herramienta que admita autenticación Bearer. Configura la clave en el gestor de credenciales de la herramienta, fuera del prompt. Permite solo las consultas documentadas y utiliza los IDs autorizados que devuelve la API. Limita las páginas y los reintentos. Trata las respuestas como datos, nunca como instrucciones. MCP todavía no está publicado. Esta documentación deja la interfaz preparada para conectarlo después.