GIT API är samlingsnamnet på en serie funktioner för att läsa och skriva data till Golfsveriges verksamhetssystem GIT. API-licensen omfattar i stort sett samtliga delar av GIT, inklusive tidbokning och handicap.
Det finns två licensmodeller
Kommersiell användar- och utvecklarlicens är till för företag som säljer eller licensierar appar, webbpubliceringssystem, bokningstjänster, ekonomitjänster, statistiktjänster med mera.
Som kommersiell aktör betalar du en årlig avgift för API-licensen, enligt en standardprislista för olika licenspaket. Detta gäller även aktörer som vill utveckla produkter eller tjänster för golfspelare, oavsett om den ska vara kostnadsfri för spelaren eller en betaltjänst.
Användar- och utvecklarlicens för klubbar är till för svenska golfklubbar och golfbolag anslutna till SGF (nedan kallat klubb). Licensen får användas av klubben för egen utveckling av app eller hemsida, men får inte lämnas ut till aktörer som tillhör gruppen som måste teckna en kommersiell licens.
Klubben betalar en startavgift samt en årlig avgift för GIT API-licensen enligt en standardprislista som gäller för klubbar. Ett avtal för licensen tecknas också mellan klubben och SGF.
Så fungerar de två licenserna
Vill ditt företag utveckla digitala tjänster för golfmarknaden? Då kan du teckna en kommersiell GIT API-licens med Svenska Golfförbundet.
Externa företag kan teckna en kommersiell användar- och utvecklarlicens för GIT API, för att utveckla produkter och tjänster som faller utanför det primära kärnområdet för GIT.
På så sätt kan vi bredda möjligheterna med GIT och skapa smarta och effektiva tjänster som bidrar till ett starkt Golfsverige.
Tjänster och områden
Den kommersiella API-licensen omfattar i stort sett samtliga delar av GIT. Den är till för företag som säljer eller licensierar olika former av applikationer och mobila tjänster.
Licensen gäller även aktörer som vill utveckla produkter eller tjänster för golfspelare, oavsett om den ska vara kostnadsfri för spelaren eller en betaltjänst.
Exempel på områden: kassasystem, bokningstjänster, TV-visning, handicapregistrering, tävlingsresultat, statistik- och rapportverktyg, webbpubliceringssystem, e-postverktyg, banguider och scorekort.
Licensavgift
Licensavtalet tecknas med Svenska Golfförbundet, som är huvudman för GIT. Som kommersiell aktör betalar du en startavgift samt en årlig avgift för API-licensen enligt en standardprislista för olika licenspaket.
Totalkostnaden beror bland annat på applikation, omfattning, volym, behov av utvecklarstöd, krav på centrala tester och godkännande.
Prislista, exempel och mer information
Exempelpaket inklusive start- och årsavgift
Teknisk information om GIT API
Do's & Dont's för företag och klubbar som utvecklar med GIT API
Vill din golfklubb presentera delar av er information från GIT på er hemsida eller i en egenutvecklad app? Då kan ni ansöka om en klubblicens för GIT API.
Idag använder de flesta klubbar GIT widgets istället för att utveckla egna API-lösningar.
Med dem kan klubben snabbt och helt utan utvecklarinsatser publicera information från GIT på klubbens egen webbplats.
Exempel på GIT widgets: medlemsansökan, aktuellt bokningsläge, slopekalkylator och tävlingskalender.
Denna GIT API-licens är till för golfklubbar och golfbolag i Sverige som är anslutna till SGF.
Licensen får användas av klubben för egen utveckling av app eller hemsida, men får inte lämnas ut till aktörer som tillhör gruppen som måste teckna en kommersiell licens.
Klubben betalar en startavgift på 5 000 kronor exkl. moms samt en årlig avgift på 1 500 kronor exkl. moms för GIT API-licensen.
Ett avtal för licensen tecknas också mellan klubben och SGF.
Det här ingår i klubbens licens:
Golfens inloggning, kontroll att Golf-ID och Min Golf lösenordet matchar i GIT. Kontroll att golfspelaren är medlem i klubben.
Hämta information om klubbens medlemmar (medlemsmatrikel)
Hämta information om klubbens banor
Gemensamt för funktionerna är att det går att läsa ut data ur GIT via API-licensen, men inte skriva in data.
Frågor & svar inför förändringar 2025
Den 31 mars 2025 upphör alla nuvarande klubblicenser för GIT API, som då kommer att stängas. Här är svar på vanliga frågor om hur detta kan påverka din klubb:
Hur vet jag om vår klubb använder GIT API klubblicens?
Om din klubb har ett medlemsregister på hemsidan som endast medlemmar kan logga in på, använder ni förmodligen GIT API klubblicens.
Min klubb använder GIT API, vad behöver jag göra nu?
Kontakta er nuvarande leverantör av hemsidan* för att ta reda på om de har, eller planerar att teckna, en kommersiell GIT API licens. De får inte längre använda er klubblicens för att utveckla tjänster för er hemsida.
*Använder ni Dizparc, Golfpress, Kust-IT, eller Tietoevry behöver ni inte göra något. De har redan tecknat avtal.
Min klubb utvecklar själva. Kan vi teckna ett eget avtal?
Ja, det kommer fortsatt finnas en utvecklarlicens för klubbar anslutna till SGF, men ni måste teckna ett nytt licensavtal om ni vill fortsätta använda GIT API.
Läs mer och fyll i beställningsformuläret via länken längre ner på sidan.
Ansök om en GIT API-licens för klubben
För att klubben ska få tillgång till den avgiftsfria GIT API-licensen behöver du fylla i ett beställningsformulär.
I formuläret ska ni ange en kontaktperson, som är den som representerar klubben för API-licensen och får information vid eventuella ändringar i API. Ni ska också fylla i uppgifter om klubbens firmatecknare.
Fyll i beställningsformuläret här
När ni skickat in er beställning sker följande:
Klubbens firmatecknare får ett GIT API-integrationsavtal för digital signering
När avtalet är undertecknat:
– SGF skickar API-information till kontaktpersonen
– Firmatecknaren får inloggningsuppgifter via SMS
OBS! Kom ihåg att lägga till er API-kontaktperson i GIT med rollen Ansvarig för GIT API Klubblicens.
När klubben ansöker om GIT API-licens åtar ni er att:
Följa riktlinjerna i Do’s & Dont’s för korrekt användning av API (se nedan)
Hantera kontaktuppgifter enligt dataskyddsförordningen (GDPR)
Den 1 januari 2025 uppdaterades licensmodellerna för GIT API. Detta för att komma tillrätta med en marknadsmässig obalans, då kommersiella företag använt klubblicensen för utveckling.
Även golfklubbar behöver nu skriva på ett licensavtal, och det har förtydligats att externa företag inte får använda klubbarnas avgiftsfria licens för att utveckla produkter och tjänster.
Bakgrund till förändringarna
Sedan GIT lanserades 2005 har externa företag och kommersiella aktörer kunnat teckna en API-licens och få tillgång till att läsa och skriva datauppgifter till GIT. Licensen har tecknats genom SGF, som huvudman för GIT.
Golfsverige måste erbjuda API-licensen till marknaden på ett rättvist och opartiskt sätt, och till en skälig årlig avgift. Alla aktörer erbjuds därför exakt samma avtals- och avgiftsvillkor.
Intäkterna från licensverksamheten går oavkortat till finansieringen av GIT, vilket framgår tydligt, bland annat i SGF:s årsredovisningar.
Parallellt med licensieringen till golfmarknaden har det funnits en avgiftsfri klubblicens. Den har gett klubbarna möjlighet att utveckla egna applikationer kopplade till GIT, utan syfte att sälja data eller teknik på marknaden.
Klubblicensen var särskilt uppskattad och använd under början av 2000-talet, när ideella krafter utvecklade klubbarnas hemsidor. Det behovet har efterhand matats av.
Tyvärr har ett antal kommersiella aktörer missbrukat klubblicensen. Genom att använda den enskilda klubbens avgiftsfria licens har dessa aktörer fått en lägre teknikkostnad än de som följt regelverket och tecknat GIT API-licens med SGF.
Detta skapade en obalans på marknaden som varken SGF eller golfklubbarna får medverka eller delta i. För att komma till rätta med denna obalans har SGF förtydligat licenserna för GIT API enligt de två modellerna ovan, samt uppdaterat prislistan.
De nya licensmodellerna och den nya prislistan gäller från och med 1 januari 2025.
Att tänka på vid kommersiell licens
Om du tecknar en kommersiell licens med GIT är det viktigt att följa riktlinjerna i Do’s & Don’ts-dokumentet ovan. Nedan hittar du fler tips som gör det enklare att göra rätt från början.
Vid användning av Golf-ID
Licensen ”Kontroll av Golfens inloggning” är endast tillåtet för produkter och tjänster som har licensavtal med SGF och koppling till GIT, där golfspelaren alltid måste verifiera koppling till sitt Golf-ID med sitt Min Golf-lösenord.
Exempel:
Att ha en öppen sökning på Golf-ID är inte tillåtet, sökning med Golf-ID får endast ske när inloggning i en tredjeparts-applikation har skett.
Om registrering görs i en tredjeparts-applikation med koppling till ett Golf-ID, måste användaren verifiera kopplingen till sitt Golf-ID och Min Golf-lösenord via ”Kontroll av Golfens inloggning”.
Vid sökning med namn
Ska golfspelare söka på namn för att exempelvis lägga till en golfvän i er applikation, behöver sökningen ske med minst två bokstäver i för- och efternamn och hemmaklubb måste anges.
Vid bokning eller hämtning av bokning i GIT
För att du ska kunna skapa eller hämta bokningar från GIT behöver följande kriterier uppfyllas:
Att du har avtal med respektive golfklubb
Att du läggs till som ett ”Bokande system” i GIT
Att klubben aktiverar er/godkänner er applikation för bokning på klubbens banor
Externa aktörer kan bara hämta bokningsdata på person eller bana och exponera den i sin app om bokningen skickats in/skapats via aktörens egen app/tjänst. Övriga bokningar går inte att hämta och exponera i extern app. Två undantag finns:
När en bokning för innevarande dag hämtas för att kunna ankomstmarkeras (om aktören har rätt att ankomstmarkera och klubben bockat för att “Tredjepartsleverantör kan ankomstmarkera” i GIT)
När en bokning för innevarande dag hämtas för att kunna mata in score för ronden och därefter skicka in HCP-justering till GIT, om aktören har rätt att skicka in HCP-registreringar
Vid hämtning av medlemsdata från golfklubb
För att du ska kunna hämta medlemsdata från en golfklubb behöver följande utföras:
Att du läggs till som en ”tredjepart med rätt att hämta medlemsdata” i GIT
Att den aktuella klubben aktiverar er i GIT
Vid tävling och HCP-rapportering
GIT API Utvecklarlicens för området Tävling ger tillgång till att läsa tävlingsprogram (per klubb och tidsperiod), deltagarlista (anmälda spelare), startlista och resultatlista inklusive hål-scorer.
Det finns även metoder för att rapportera in hål-scorer i realtid. Utveckling kring detta sker mot webbaserade GIT Tävling.
Ett krav för att få tillgång till inrapporteringsfunktionen är att tävlingen i sig körs fullt ut i GIT Tävling, dvs. allt från anmälningar, lottning och starttider till slutligt resultat måste registreras i GIT. I annat fall skulle flera för klubbarna och golfspelarna viktiga funktioner fallera. Det gäller inte minst den efterföljande registreringen av HCP-påverkande score.
Handicapsystemet är omgärdat av ett regelverk som i detalj styr vad och hur golfresultat får registreras som handicappåverkande eller inte. Stöd för världshandicapen (WHS) finns i GIT.
Vid inskick av uppgifter till GIT
Vissa licenser ger möjlighet att exportera (spara och registrera) uppgifter i GIT-databasen. Det krävs dock att SGF testar och godkänner den tekniska lösningen innan skarp driftsättning får ske.
Process för integrationsavtal
Innan vi tecknar ett GIT API integrationsavtal går vi igenom era behov som tredjepartsleverantör. Därefter följer avtalsskrivning, utveckling och testning av er integration. Klicka nedan för att läsa mer om processen.
Process vid tecknande av ett GIT API integrationsavtal
Steg 1. Via dialog/möte kommer vi först överens om hur ert behov som tredjepartsleverantör ser ut, och villkoren för avtal.
Vi ger er pris, startavgift samt årlig avgift
Vi reder ut om klubb måste aktivera alt. godkänna er för att hämta data kring klubben
Vi sätter samman ett avtalsförslag för påseende
Steg 2. Om ni godkänner avtalsförslaget behöver vi följande från er för att färdigställa avtalet:
Företagsuppgifter: organisationsnummer, adressuppgifter samt e-postuppgifter dit vi ska skicka faktura.
Firmatecknare: namn, e-post och personnummer.
Teknisk kontaktperson: namn, e-post och mobilnummer. Kommer att vara mottagare av credentials.
Kontaktperson/er (kan vara fler): namn, e-post och mobilnummer. Kommer att få viktig information kring er integration, exempelvis releaseinformation.
Steg 3. Vi tar fram credentials och ni får en kontaktperson i GIT-teamet som tar fram testdata till er.
Ni får dokumentation och credentials till stage (vår testmiljö)
Notera att GIT Partner-API och GIT Tävling API är två olika set av credentials.
Om behov finns lägger vi till möjlighet för klubb att i GIT aktivera/godkänna hämtning alt. skicka in data till GIT.
Om ni ska skicka in data till GIT så har vi protokoll för det, vi verifierar alltid all data som skickas in i GIT.
Steg 4: När ni är redo för produktion så får ni credentials till produktionsmiljön.
Steg 5. Som tredjepartsleverantör kan ni skriva en presentation av er tjänst, inkl. kontaktuppgifter, som vi lägger ut på sidan help.golf.se
Rättigheter och skyldigheter
Alla aktörer som tecknar ett GIT API licensavtal med SGF får ett paket av rättigheter, men också skyldigheter och ansvar i händelse av missbruk, säkerhetsproblem och dataläckage, kopplat till bland annat GDPR och GIT-bestämmelserna. Teknik relaterad till GIT får inte heller erbjudas som så kallad öppen källkod (open source code).
För mer information, ladda ner dokumentet nedan. Riktlinjerna gäller både för den kommersiella och avgiftsfria licensen.
Do's & Dont's för företag och klubbar som utvecklar med GIT API
Företag med integration mot GIT
Ett stort antal företag har redan idag, via en API-licens, utvecklat produkter och tjänster med koppling till GIT. På Onlinehjälpen hittar du en lista över samtliga tjänster och leverantörer, fördelat på olika kategorier och områden.
Kontaktperson GIT API
