Feeds externos

Muestra en tu propio sitio web una competencia en la que juegan tus equipos, pero que organiza otra entidad. Los feeds externos traen una tabla de posiciones y un calendario de partidos publicados por tu organismo rector (o por cualquier fuente que pueda servir un archivo JSON pequeño) y los muestran en modo de solo lectura dentro de tu sección Competencias, con actualización automática.

Los feeds externos están disponibles desde el plan Standard.

Quién puede usar esto

Los administradores, y los moderadores que tengan el permiso Gestionar competencias.

Qué hay en la página

• Una tarjeta por feed, que muestra si está visible u oculto, cuándo se obtuvo por última vez, cuántas divisiones incluye y cualquier problema al obtenerlo.
• Un formulario de edición en cada tarjeta, además de los botones Actualizar ahora y Quitar.
• Un formulario Agregar un feed al final.

Cada feed visible aparece en tu sitio público en Competencias → Competencias externas, con su propia página en /competitions/external/<slug> que muestra la tabla de posiciones y los partidos de cada división.

Paso a paso

1. Pide a tu asociación la URL del feed de ClubHelix de tu competencia, o publica una tú mismo; el formato es un documento JSON pequeño (consulta la referencia de campos más abajo).
2. Selecciona Agregar un feed y escribe el nombre de la competencia, una dirección de página y la URL del feed.
3. Guarda. El feed se obtiene de inmediato, así que sabrás en el momento si la URL sirve datos válidos.
4. Deja marcada la opción Mostrar en el sitio público y la competencia aparecerá en tu página Competencias en cuanto se carguen los datos.

Referencia de campos

• Nombre de la competencia: el título de la página pública.
• Dirección de la página (slug): letras minúsculas, dígitos y guiones; forma la URL pública.
• Fuente de datos (atribución): quién organiza la competencia; se muestra como "Datos de …" en la página pública.
• URL del feed: una dirección pública https:// que sirve el documento del feed. Se rechazan las direcciones privadas o locales.
• Actualizar cada: con qué frecuencia se vuelve a obtener el feed (de 30 minutos a una vez por semana). Durante la temporada, elige 30 a 60 minutos si el feed incluye resultados en vivo.

El documento del feed es un JSON con esta forma:

{
  "competition": {
    "name": "State League Division 2",
    "season": "2026",
    "updated_at": "2026-07-20T09:00:00Z"
  },
  "divisions": [
    {
      "name": "Division 2",
      "ladder": [
        {
          "team": "Harbourside",
          "played": 10,
          "wins": 8,
          "draws": 1,
          "losses": 1,
          "points_for": 312,
          "points_against": 208,
          "points": 25
        }
      ],
      "fixtures": [
        {
          "round": 11,
          "home": "Harbourside",
          "away": "Seacliff",
          "kickoff": "2026-07-26T04:30:00Z",
          "venue": "Memorial Oval",
          "status": "upcoming"
        },
        {
          "round": 10,
          "home": "Seacliff",
          "away": "Harbourside",
          "home_score": 41,
          "away_score": 55,
          "status": "complete"
        }
      ]
    }
  ]
}

Hasta 12 divisiones, 40 filas de tabla de posiciones y 300 partidos por división; se rechazan los documentos de más de 500 KB. ladder y fixtures son opcionales en cada división.

Consejos y preguntas frecuentes

• ¿El feed falló, pero la página sigue mostrando datos? Una obtención fallida nunca borra la última copia correcta: la página pública la sigue mostrando hasta que una obtención vuelva a funcionar. El error solo aparece en esta página de administración.
• Los resultados van atrasados respecto de la competencia en vivo. Los feeds son copias: los datos están tan actualizados como los publica la fuente, según el intervalo de actualización que elegiste. Actualizar ahora fuerza una actualización inmediata.
• Es solo para mostrar, por diseño. Los partidos externos nunca aparecen en tus propios calendarios de partidos, tablas de posiciones, centro de partidos ni estadísticas: esos pertenecen a las competencias que organizas en ClubHelix.
• ¿Podemos ofrecer nuestra competencia de ClubHelix como feed para otros? Todavía no: por ahora los feeds solo sirven para importar.