Licenser för GIT API.

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”. 

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.

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

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

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. 

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.

För att våra tjänster ska fungera stabilt och snabbt för alla användare accepterar vi inte onormalt många eller onödiga anrop till vårt API.

Det innebär att:

❌ du inte bör skicka upprepade förfrågningar i snabb följd i onödan

❌ du bör undvika så kallad "polling" (att hela tiden fråga om något har hänt)

Vi erbjuder webhooks. Genom dessa får du information direkt när något händer. GIT erbjuder webhooks inom följande områden:

• Bana

• Bokning

• HCP

• Klubb

• Person

OBS! Det är aldrig tillåtet att bevaka starttider, oavsett om det är via webhooks eller polling.

I GIT finns möjlighet för en klubb att ange Tvingande betalning vid bokning.

Om en bokning sker via Min Golf eller via appen Min Golf Bokning så har golfspelaren 15 minuter på sig att betala sin starttid.

Men om en starttid blir bokad via GIT API via annan app/terminal (tredjepartsleverantör) gäller inte funktionen Tvingande betalning.

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: företagsnamn, organisationsnummer, adressuppgifter samt e-postuppgifter dit vi ska skicka faktura.

• Firmatecknare: namn, e-post och personnummer (används för digital signering).

• 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å GIT-hjälpen.

Web scraping – det vill säga automatiserad insamling av data eller annan åtkomst till Min Golf med hjälp av script, botar, programvara eller tekniska lösningar som inte är uttryckligen godkända av Svenska Golfförbundet – är inte tillåtet.

Min Golf får endast användas via officiella gränssnitt och i enlighet med gällande användarvillkor. All form av försök att kringgå tekniska skydd, belasta systemen onormalt eller automatiskt hämta information strider mot dessa villkor.

Vid upptäckt av otillåten användning, inklusive men inte begränsat till web scraping, kommer vi att vidta åtgärder. Detta kan innebära:

• Omedelbar begränsning av åtkomst till Min Golf

• Svartlistning (begränsning) av berörda Golf-ID:n

• Ytterligare åtgärder vid behov, inklusive rättsliga åtgärder

Åtgärderna gäller både den som utför handlingen och de Golf-ID:n som används för ändamålet.

Har du behov av en kommersiell koppling till GIT så är alternativet ett GIT API integrationsavtal (se ovan).