Feeds externos

Mostre no seu próprio site uma competição em que suas equipes jogam — mas que outra pessoa organiza. Os feeds externos trazem a classificação e a tabela de jogos publicadas pela sua entidade dirigente (ou por qualquer fonte capaz de servir um pequeno arquivo JSON) e as exibem, somente leitura, na seção Competições do seu site, com atualização automática.

Os feeds externos estão disponíveis no plano Standard e superiores.

Quem pode usar

Administradores, além de moderadores com a permissão Gerenciar competições.

O que há na página

• Um cartão por feed, mostrando se está no ar ou oculto, quando foi a última busca, quantas divisões ele traz e qualquer problema na busca.
• Um formulário de edição em cada cartão, além dos botões Buscar agora e Remover.
• Um formulário Adicionar um feed no final.

Cada feed no ar aparece no seu site público em Competições → Competições externas, com uma página própria em /competitions/external/<slug> que mostra a classificação e a tabela de jogos de cada divisão.

Passo a passo

1. Peça à sua federação a URL do feed ClubHelix da sua competição — ou publique um você mesmo; o formato é um pequeno documento JSON (veja a referência de campos abaixo).
2. Selecione Adicionar um feed e informe o nome da competição, um endereço de página e a URL do feed.
3. Salve. O feed é buscado na hora, então você fica sabendo imediatamente se a URL serve dados válidos.
4. Deixe Mostrar no site público marcado e a competição aparece na sua página Competições assim que os dados forem carregados.

Referência de campos

• Nome da competição — o título da página pública.
• Endereço da página (slug) — letras minúsculas, números e hifens; forma a URL pública.
• Fonte dos dados (atribuição) — quem organiza a competição; aparece como "Dados de …" na página pública.
• URL do feed — um endereço público https:// que serve o documento do feed. Endereços privados ou locais são recusados.
• Atualizar a cada — com que frequência o feed é buscado novamente (de 30 minutos a semanal). Escolha 30 a 60 minutos durante a temporada se o feed trouxer resultados ao vivo.

O documento do feed é um JSON com este formato:

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

Até 12 divisões, 40 linhas de classificação e 300 jogos por divisão; documentos com mais de 500 KB são recusados. ladder e fixtures são opcionais em cada divisão.

Dicas e perguntas frequentes

• O feed falhou, mas a página ainda mostra dados? Uma busca que falha nunca apaga o último retrato válido — a página pública continua mostrando esses dados até que uma busca volte a funcionar. O erro aparece só nesta página do painel.
• Os resultados estão atrasados em relação à competição ao vivo. Os feeds são retratos — os dados ficam tão atualizados quanto a fonte os publica, no intervalo de atualização que você escolheu. Buscar agora força uma atualização imediata.
• Isto é só para exibição, de propósito. Os jogos externos nunca aparecem nos seus próprios jogos, classificações, central de partidas ou estatísticas — esses pertencem às competições que você organiza no ClubHelix.
• Podemos enviar nossa competição do ClubHelix como feed para outros? Ainda não — por enquanto os feeds são só de importação.