Necesitas mostrar a los usuarios una lista limpia de competencias (por deporte y país) e integrarla en tu aplicación esta semana. Al final de esta guía, llamarás a un endpoint de producción que devuelve metadatos de competencia (IDs, nombres, URLs, banderas como hasStandings y hasStats), los analizarás y los integrarás en tu interfaz de usuario o flujo de trabajo en el backend.
Lo que construirás con la API de 365Scores
La API de 365Scores en Zyla API Hub devuelve datos deportivos estructurados que tu aplicación puede consumir de inmediato. Para el descubrimiento de competencias, utilizarás un endpoint que obtiene competencias para un deporte y país dados, incluyendo identificadores que necesitarás para dirigir a los usuarios a clasificaciones, partidos o estadísticas en otras partes de tu stack.
Los usos típicos incluyen:
- Seleccionadores de país y liga en flujos de incorporación.
- Utilidades administrativas para mapear IDs de competencia a modelos de contenido internos.
- Calentadores de caché o trabajos CRON para actualizar la lista activa de competencias diariamente.
Comenzando en Zyla API Hub
Abre la lista de APIs, suscríbete y obtén tu clave:
- Visita la página de la API de 365Scores en Zyla API Hub y haz clic en Suscribirse o Comenzar prueba gratuita.
- Copia tu clave API del panel de control. Todas las solicitudes utilizan Authorization: Bearer YOUR_API_KEY.
- Haz tu primera llamada al endpoint de competencia a continuación.
Zyla API Hub agrega más de 10,000 APIs públicas detrás de una cuenta y una clave. El uso se factura por suscripción con cuotas (no por llamada). Para esta API, puedes comenzar una prueba de 7 días desde la página de listado: Comenzar prueba de 7 días en la API de 365Scores.
Endpoint: Obtener competencias (por deporte y país)
Este endpoint devuelve datos de competencia limitados por deporte y país. Utilizarás los IDs en tu interfaz de usuario y almacenarás los nombres/banderas para decidir qué renderizar (por ejemplo, si una liga tiene clasificaciones o estadísticas).
- Método: GET
- URL: https://zylalabs.com/api/13503/365scores-api/29728/get-competitions
- Parámetros de consulta requeridos:
- sportId
- countryId
- langId
- timezone
- Autenticación: Authorization: Bearer YOUR_API_KEY
cURL que puedes copiar/pegar
curl -s -X GET "https://zylalabs.com/api/13503/365scores-api/29728/get-competitions?sportId=1&countryId=11&langId=1&timezone=Europe%2FBerlin" \
-H "Authorization: Bearer YOUR_API_KEY"
Respuesta JSON oficial
{
"sports": [
{
"id": 1,
"name": "Football",
"nameForURL": "football",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Portuguese Primeira Liga",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Standings",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Standings",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…
Campos que realmente usarás
- competitions[].id: Clave primaria que almacenarás y pasarás por tu sistema.
- competitions[].name y longName: Cadenas de visualización para etiquetas de UI.
- competitions[].hasStandings, hasStats, hasTransfers: Controlan características de UI condicionalmente.
- competitions[].currentSeasonNum y currentStageNum: Contexto para vistas conscientes de la temporada.
- competitions[].nameForURL: Útil para URLs o slugs amigables.
- sports[0] y countries[0]: Confirman el alcance que solicitaste (por ejemplo, fútbol en Portugal).
Nota sobre zonas horarias: la solicitud incluye timezone=Europe/Berlin. Mantenlo consistente a través de tus llamadas para que cualquier campo de fecha/hora que encuentres de endpoints relacionados permanezca alineado. El ejemplo anterior no incluye marcas de tiempo, pero usar una cadena de zona horaria estable es una buena práctica en toda tu integración.
Ejemplo en Python: obtener y filtrar competencias activas
El fragmento a continuación llama al mismo endpoint, aplica el encabezado de autorización y filtra las competencias inactivas antes de imprimir una carga útil compacta que puedes entregar a un frontend.
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/13503/365scores-api/29728/get-competitions"
params = {
"sportId": "1",
"countryId": "11",
"langId": "1",
"timezone": "Europe/Berlin"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(URL, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
competitions = data.get("competitions", [])
active = [c for c in competitions if c.get("isActive")]
# Forma mínima para tu UI
result = [
{
"id": c["id"],
"name": c.get("name") or c.get("longName"),
"slug": c.get("nameForURL"),
"hasStandings": c.get("hasStandings"),
"hasStats": c.get("hasStats"),
"season": c.get("currentSeasonNum"),
"stage": c.get("currentStageNum")
}
for c in active
]
print({
"sport": (data.get("sports") or [{}])[0].get("name"),
"country": (data.get("countries") or [{}])[0].get("name"),
"count": len(result),
"competitions": result[:5] # vista previa de las 5 principales
})
Notas de implementación que ahorran tiempo
- Los IDs son claves estables: almacena competitions[].id como tu referencia canónica. Los nombres pueden cambiar entre temporadas; los slugs (nameForURL) son útiles pero no son claves primarias.
- Banderas de características: hasStandings, hasStats, hasTransfers te permiten ocultar o mostrar pestañas sin sondear endpoints adicionales.
- Caché: las listas de competencias a nivel de país no cambian minuto a minuto. Almacena en caché durante horas e invalida cuando despliegas o en un horario diario.
- Localización: usa langId de manera consistente para el idioma del cliente. Si admites múltiples locales, almacena resultados por (sportId, countryId, langId).
- Zonas horarias: mantén la zona horaria consistente a través de tu aplicación para evitar diferencias sutiles en fechas derivadas. Europe/Berlin se usa en el ejemplo; elige una estrategia y mantente con ella.
Paso a paso: integrando detalles de competencia en tu aplicación
1) Decide tu alcance
Elige sportId y countryId para el alcance de lanzamiento de tu producto. En el ejemplo anterior, sportId=1 (Fútbol) y countryId=11 (Portugal). Puedes consultar diferentes países o deportes cambiando estos IDs según sea necesario en tu integración.
2) Llama al endpoint del lado del servidor
Envía el encabezado Authorization: Bearer desde un backend seguro. Evita exponer YOUR_API_KEY en el código del lado del cliente. La respuesta incluye matrices de deportes, países y competencias, que puedes mapear a tu modelo de página.
3) Normaliza y almacena
Persiste el id, nombre, slug y banderas de competencia. La mayoría de los equipos almacenan una fila mínima más el JSON sin procesar para depuración.
4) Renderiza tu UI
Muestra un selector de país y liga poblado desde tu caché. Renderiza condicionalmente pestañas usando las banderas (por ejemplo, muestra una pestaña de “Clasificaciones” solo cuando hasStandings sea verdadero).
5) Actualiza según un horario
Reconstruye tu caché a un ritmo que se ajuste a tu caso de uso (por ejemplo, diariamente). Realiza un seguimiento de la última actualización en los metadatos para que puedas solucionar problemas rápidamente si una lista de ligas parece obsoleta.
Endpoints relacionados que podrías usar a continuación
Si tu vista de competencia también enlaza a páginas centradas en jugadores, estos endpoints devuelven detalles de jugadores, partidos y estadísticas. Son separados del descubrimiento de competencias, pero a menudo aparecen juntos en las mismas áreas de producto.
Obtener detalles del jugador
- Método: GET
- URL: https://zylalabs.com/api/13503/365scores-api/29748/get-player-details
- Params: playerId, langId, timezone
{
"sports": [
{
"id": 1,
"name": "Fútbol",
"nameForURL": "football",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Primeira Liga Portuguesa",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Clasificaciones",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Clasificaciones",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…
Obtener partidos del jugador
- Método: GET
- URL: https://zylalabs.com/api/13503/365scores-api/29749/get-player-matches
- Params: playerId, langId, timezone
Obtener estadísticas del jugador
- Método: GET
- URL: https://zylalabs.com/api/13503/365scores-api/29750/get-player-stats
- Params: playerId, langId, timezone
Llamando a la API desde un agente de IA a través de MCP
Cada API en Zyla puede ser llamada desde clientes compatibles con MCP (Claude Code, Cursor, Windsurf, etc.). Apunta tu agente al endpoint de MCP y proporciona tu clave como un parámetro de consulta al configurar el host de la herramienta: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Una vez configurado, tu agente puede invocar el mismo endpoint de competencia que viste arriba con los parámetros requeridos. Para documentación sobre MCP en sí, consulta: MCP.
Errores comunes y solución de problemas
- Errores 401: Asegúrate de que el encabezado Authorization sea exactamente Authorization: Bearer YOUR_API_KEY sin espacios adicionales o esquemas.
- Array de competencias vacío: Verifica que sportId y countryId sean válidos para tu alcance. Prueba un par diferente si tu combinación inicial no está devolviendo ligas.
- Desajuste de localización: Si tu UI está en un idioma específico, mantén langId consistente a través de las llamadas. Almacena resultados por idioma.
- Diferencias de zona horaria: Estandariza la zona horaria a nivel de aplicación para evitar comportamientos mezclados de UTC/local cuando agregues otros endpoints más adelante.
Patrones de integración en el mundo real
- Menús renderizados en el servidor: Al iniciar la aplicación, obtén competencias y renderiza un desplegable de ligas por país. Almacena solo id, nombre, slug y las banderas de características.
- Ingesta por lotes: Trabajo nocturno que itera los países que soportas y actualiza los datos de competencia en tu base de datos o tienda KV.
- Páginas con características restringidas: No enlaces a clasificaciones o estadísticas si las banderas de la API para una liga dicen que esos recursos no están disponibles (hasStandings, hasStats).
- Enlaces profundos: Usa nameForURL para construir slugs legibles por humanos mientras enrutas por el id numérico detrás de escena.
FAQ
¿Puedo cambiar el deporte y el país?
Sí. Pasa el sportId y countryId apropiados en la cadena de consulta. El ejemplo utiliza Fútbol en Portugal; actualiza los IDs para que coincidan con tu alcance.
¿Necesito enviar una clave API en cada solicitud?
Sí. Incluye Authorization: Bearer YOUR_API_KEY en cada llamada desde tu código del lado del servidor.
¿Con qué frecuencia debo actualizar la lista de competencias?
Las listas de competencias no cambian minuto a minuto. La mayoría de los equipos almacenan en caché durante horas o actualizan diariamente. Elige un ritmo alineado con las necesidades de tu producto.
¿Qué pasa si necesito páginas de jugadores vinculadas desde una vista de competencia?
Usa los endpoints de jugador mostrados arriba (detalles, partidos, estadísticas) para poblar páginas o modales específicos de jugadores. Son llamadas separadas del descubrimiento de competencias.
¿Hay un plan gratuito?
Las opciones de acceso pueden cambiar. Consulta la página de la API para las opciones de acceso y precios actuales. Puedes comenzar una prueba de 7 días desde el listado del mercado.
¿Listo para enviar detalles de competencia? Suscríbete y obtén tu clave de la lista de la API de 365Scores en Zyla API Hub: Comenzar prueba de 7 días en la API de 365Scores. Luego, coloca el ejemplo de cURL o Python en tu backend, almacena en caché los resultados y activa tu UI.
Respuesta oficial de la API
{
"sports": [
{
"id": 1,
"name": "Fútbol",
"nameForURL": "football",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Primeira Liga Portuguesa",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Clasificaciones",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Clasificaciones",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…