Riksidrottsförbundets API:er

Sidan uppdaterades: 26 september 2023

Denna sida riktar sig till er som vill använda Riksidrottsförbundets API:er för att bygga integrationer mot Riksidrottsförbundets centrala register och databaser. Här finns information om vilka API:er som är tillgängliga och hur ni får tillgång till dem.

API:erna är för närvarande tillgängliga för leverantörer som arbetar på uppdrag av specialidrottsförbund samt leverantörer av föreningssystem. Enskilda föreningar kommer ha möjlighet att ansluta längre fram när vi har en automatiserad process för anslutning.

Åtkomst och tillgänglighet

Riksidrottsförbundet erbjuder API:er för leverantörer som arbetar på uppdrag av organisationer inom idrottsrörelsen och som vill bygga integrationer mot Riksidrottsförbundets centrala register och databaser.

API:erna finns både i testmiljö och i produktionsmiljö. Innehållet i respektive API, hur de kan användas och hur man får åtkomst till API:erna beskrivs mer utförligt i Riksidrottsförbundets utvecklarportal.

Testmiljön används för att testa integrationerna och i den får endast testdata förekomma. Produktionsmiljön hanterar skarp data såsom personuppgifter och åtkomst till Riksidrottsförbundets centrala register och databaser. För åtkomst till produktionsmiljön krävs därför avtal som bl.a. reglerar personuppgiftsbehandling. Notera att för närvarande erbjuds API:er för specialidrottsförbund och dessa behöver ha ett avtal med Riksidrottsförbundet som omfattar de API:er som de önskar åtkomst till. Om nytt/kompletterande avtal behöver tecknas, sker detta genom att fylla i formuläret Begäran om åtkomst till produktionsmiljön.

Vid frågor går det bra att skicka ett e-postmeddelande till systemintegration@rf.se.

Tillgängliga API:er i testmiljö

Följande API:er som är samlade i testmiljön i ett paket som heter RF API:

Version 2.0 av följande API:er
- Sök organisation: skapar möjlighet att bygga tjänster för att söka efter organisationer inom svensk idrottsrörelse, t ex idrottsföreningar. Exempel på implementation, Hitta inom idrottsrörelsen
- Sök utbildning: skapar möjlighet att bygga tjänster för att söka efter utbildningar som erbjuds av svensk idrottsrörelse och finns i Riksidrottsförbundets och SISU Idrottsutbildarnas centrala databaser. Exempel på implementation, se sisuidrottsutbildarna.se
- Ansökan om namnbyte: skapar möjlighet för idrottsföreningar attt ansöka om namnbyte för sin förening. Ansökan om namnbyte: exempel på implementation

Nytt API: Föreningsansökan. skapar möjlighet att bygga tjänster som idrottsföreningar kan använda för att ansöka om medlemsskap i något av Riksidrottsförbundets anslutna specialidrottsförbund eller någon av SISU Idrottsutbildarnas medlemsorganisationer. Föreningens ansökan landar via API:et i IdrottOnline Administration där den mottagande organisationen kan hantera denna. Exempel på hur den är implementerad på rf.se.

Åtkomst till API:er i testmiljön

För att få åtkomst till API:er i testmiljön:

Gå till Riksidrottsförbundets utvecklarportal i testmiljö: https://developer.test.rf.se/
Skapa ett konto genom att klicka på SIGN UP
Prenumerera på RF API där uppdaterade versioner av RF:s API:er finns
Riksidrottsförbundet konfigurerar din åtkomst

Observera att testmiljön är tillgänglig vardagar kl 08.00 - 18.00.

Tillgängliga API:er i produktionsmiljö

Nytt API: Föreningsansökan. skapar möjlighet att bygga tjänster som idrottsföreningar kan använda för att ansöka om medlemsskap i något av Riksidrottsförbundets anslutna specialidrottsförbund eller någon av SISU Idrottsutbildarnas medlemsorganisationer. Föreningens ansökan landar via API:et i IdrottOnline Administration där den mottagande organisationen kan hantera denna.
Version 1.0 har ersatts med version 2.0 av följande API:er
- Sök organisation: skapar möjlighet att bygga tjänster för att söka efter organisationer inom svensk idrottsrörelse, t ex idrottsföreningar.
- Sök utbildning: skapar möjlighet att bygga tjänster för att söka efter utbildningar som erbjuds av svensk idrottsrörelse och finns i Riksidrottsförbundets och SISU Idrottsutbildarnas centrala databaser.
- Ansökan om namnbyte: skapar möjlighet för idrottsföreningar attt ansöka om namnbyte för sin förening.

Observera att version 1.0 ersätts av version 2.0. Ni som använder version 1.0 kan fortsätta använda dessa men behöver uppgradera till de nya versionerna före årsskiftet 2023/2024.

Åtkomst till API:er i produktionsmiljön

För att få åtkomst till API:er i Riksidrottsförbundets produktionsmiljö krävs ett avtal. Fyll i detta formulär så återkommer vi så snart vi kan.

När avtalet är klart tilldelas organisationen verifierbara autentiseringsuppgifter som ger åtkomst till relevant data. Med relevant data menas exempelvis att ett specialidrottsförbund enbart får åtkomst till information om sina föreningar. API:erna nås sedan genom organisationens konto på RF:s utvecklarportal i produktionsmiljö.

Kommande API:er

Detaljerad information om pågående arbete och kommande leveranser av API:er har vi samlat på Digitalisering/Integration och APIer.

Ytterligare behov

Riksidrottsförbundet arbetar kontinuerligt med att utveckla fler API:er för att skapa största möjliga värde för svensk idrottsrörelse. Har du önskemål om ett API, skicka in dina önskemål via detta formulär:

Önskemål om API (formulär)

Sidan publicerades: 8 november 2022

Riksidrottsförbundets utvecklarportal

RF erbjuder API:er för dig som arbetar på uppdrag av specialidrottsförbund och idrottsföreningar som vill bygga integrationer mot RF:s centrala databaser.

Observera att testmiljön är tillgänglig vardagar kl 08.00 - 18.00. Skapa ett konto i testmiljön:

Testmiljö

För att få åtkomst till API:er i RF:s produktionsmiljö krävs ett avtal. Information om detta hittar du när du klickar på knappen nedan.

Produktionsmiljö

Vill du felanmäla ett API?

För att felanmäla ett av Riksidrottsförbundets API:er, vänligen fyll i vårt felanmälningsformulär.

Felanmälan

Prenumerera på denna sida

Så får du ett e-postmeddelande när vi publicerar ny information om Riksidrottsförbundets API:er.