Vad kopplingen gör
Via sitt API för föreningsdata publicerar Svenska Fotbollförbundet (SvFF) varje förenings fotbollsdata: lag, serier, spelprogram, resultat och tabeller. Själva resultaten rapporteras av domaren i FOGIS efter varje match, och därifrån flödar de in i API:et. ClubFlow läser SvFF:s API för att hämta föreningens spelprogram, resultat, tabeller och motståndare, så att matchdatan finns i samma verktyg som trupper, speltid och spelarutveckling.
Kopplingen är enkelriktad: ClubFlow läser från SvFF:s API och skriver aldrig tillbaka. Hur resultaten når systemet förändras inte. Domarna rapporterar dem i FOGIS precis som tidigare, och ClubFlow läser helt enkelt det som publicerats.
Det här behöver ni
- Administratörsbehörighet i ClubFlow. Det är bara klubbadministratörer som kan ansluta integrationer och se API-nyckeln.
- Föreningens API-nyckel från SvFF. Nyckeln hör till föreningen (inte till en person) och ger läsbehörighet till föreningens egen data i SvFF:s API. Har föreningen ingen nyckel ännu, begär ni en hos Svenska Fotbollförbundet.
Behandla nyckeln som en hemlighet: den ska inte ligga i mejltrådar eller delade dokument. I ClubFlow sparas den krypterat, och när den väl är sparad går den inte att se igen, bara att byta ut.
Så ansluter ni föreningen
- Öppna Integrationer. Gå till Admin → Integrationer i ClubFlow och välj att ansluta SvFF. Samma import finns också som ett steg när föreningen först sätts upp i ClubFlow.
- Klistra in API-nyckeln och validera. ClubFlow kontrollerar nyckeln direkt mot SvFF:s API. Är den giltig hämtas föreningens lag, annars får ni ett tydligt fel i stället.
- Välj vilka lag som ska importeras. Ni ser föreningens alla lag hos SvFF, märkta med kategori (senior, ungdom, barn). Välj alla eller bara de lag ni arbetar med i ClubFlow. Har samma lag flera poster hos SvFF, till exempel en serie- och en cuppost, kan de grupperas till ett lag, eller kopplas till ett lag som redan finns i ClubFlow.
- Importera. ClubFlow hämtar i tur och ordning lag, tävlingar, tabeller med historik och till sist matcher och motståndare. När importen är klar visas en sammanfattning av vad som skapades och uppdaterades.
Vad som hämtas
- Lag och serieanmälningar: föreningens lag och deras engagemang i serier och cuper.
- Tävlingar och tabeller: aktuella tabeller och de senaste säsongernas historik, så långt SvFF:s API sträcker sig bakåt.
- Matcher: spelprogram och resultat, med motståndare, arenor och avsparkstider.
Två begränsningar är bra att känna till. SvFF:s API täcker de senaste säsongerna, inte hela föreningens historia. Men det ClubFlow en gång hämtat sparas, så ert arkiv växer för varje säsong. Och för barnlag publicerar SvFF inga tabeller, så de serierna visas utan tabellplaceringar även i ClubFlow.
Efter anslutningen
ClubFlow synkar föreningens data automatiskt med jämna mellanrum. Nya resultat, uppdaterade tabeller och ändrade avsparkstider kommer in utan att någon behöver göra något.
Lag som arkiveras i ClubFlow pausas i synken, och när en ny säsong börjar dyker de nya serierna upp vid nästa synk.
Säkerhet och nyckelhantering
- API-nyckeln sparas krypterat och går inte att läsa tillbaka när den väl är sparad, inte ens av klubbadministratörer.
- Nyckeln ger enbart läsbehörighet till föreningens egen data. Den kan inte användas för att ändra något hos SvFF.
- Behöver nyckeln bytas, till exempel om den hanterats oaktsamt, finns en rotationsfunktion under Integrationer: klistra in den nya nyckeln, validera, klart. Importerad data påverkas inte.
Vanliga frågor
Behöver lagledarna göra något nytt? Nej. Matchresultaten rapporteras av domaren i FOGIS precis som idag, och ClubFlow hämtar det som publicerats. Det innebär inget nytt steg för föreningen.
Hur ofta uppdateras datan? Automatiskt med jämna mellanrum.
Vad händer om nyckeln slutar fungera? Synken misslyckas utan att röra befintlig data. Rotera nyckeln under Integrationer så fortsätter synken där den slutade.
Måste alla lag importeras? Nej, ni väljer själva vilka lag som ska in i ClubFlow, och kan importera fler senare.