Vanliga frågor och svar

Hur får jag tillgång till API:et?

Se vår snabbstarts-sida

Finns det begränsningar i antal anrop?

Ja, det finns begränsningar i antal anrop din förenings användare kan göra mot API:et.

  • max 60 anrop per minut

  • max 1000 anrop per dygn

Jag är inte en del av en fotbollsförening, kan jag ändå ta del av detta API?

Förenings-API:et kan endast användas av föreningar som är medlemmar i Svenska Fotbollförbundet och till deras webbplats och/eller app. För allmänheten finns vårt öppna API innehållande vårt föreningsregister.

Jag företräder ett företag eller organisation som skulle vilja ha tillgång till ert data, hur kommer jag i kontakt med er?

Det finns särskilda API-produkter för laghemsidor och andra tjänster som behöver tillgång till spelprogram, resultat och tabeller från flera eller samtliga föreningar.

Denna åtkomst är inte kostnadsfri och kräver ett särskilt avtal med Svenska Fotbollförbundet.

Om du är intresserad av en sådan lösning, kontakta oss med information om din tjänst så återkommer vi med förutsättningar och prisinformation.

Du når oss via api-support@svenskfotboll.se.

Observera: Supporten kan inte bevilja utökad åtkomst via vanliga föreningskonton eller kostnadsfria API-prenumerationer.


Vilken data kan min förening få tillgång till?

Föreningar kan, efter godkänd anslutning, få åtkomst till sina egna uppgifter, exempelvis:

  • Matcher

  • Spelprogram

  • Resultat

  • Tabeller

  • Föreningsinformation

Åtkomsten begränsas till den egna föreningens data.


Vår förening skulle vilja komma åt ytterligare information/data, kan vi få det?

I dagsläget finns i förenings-API:et det data (och lite till) som motsvarar informationen i våra hemsidewidgets (länk till svenskfotboll.se). För närvarande finns det inga konkreta planer (roadmap etc) på att lägga till ytterligare information.


Kan jag få tillgång till spelardata eller personuppgifter via API:et?

Nej.

Fogis API tillhandahåller inte personuppgifter, spelardata eller annan individrelaterad information till externa konsumenter.

API:et är avsett för åtkomst till offentlig föreningsinformation samt föreningsspecifik verksamhetsdata för behöriga föreningar.

Supporten kan inte bevilja undantag från denna princip.

Kan vår förening få hjälp med att använda API:et av er?

Vi kan tyvärr inte hjälpa din förening att använda API:et. För att komma igång och få tillgång till API:et finns en snabbstartsguide här. Om användning av API:et är för avancerat finns alternativet att använda våra hemsidewidgets (länk till svenskfotboll.se).

Vår förening är formellt uppdelad i flera föreningar (samarbetsföreningar, AB/IF etc). Kan vi komma åt alla våra lags data?

Ja. Dock behöver ni skapa en användare för varje förening, dvs en API-nyckel per förening. Varje användare behöver ha en unik epostadress. Varje förenings användare med dess API-nyckel kommer komma åt data runt de lag som tillhör föreningen den användaren är kopplad till.

Exempel: Din Förening ABC formellt består av två föreningar, Förening A och Förening B, där Förening A innehåller herr- och dam-elitlagen och Förening B innehåller barn- och ungdomslag. Du behöver då skapa två användare, en för varje förening. När du sedan anropar API:et med API-nyckeln kopplad till Förening A kommer du få data runt lagen i Förening A (herr- och damlagen i exemplet) och när du anropar API:et med API-nyckeln för Förening B får du data för lagen i Förening B (barn- och ungdomslag).

Varför är API:et på engelska?

När API:et utvecklades togs ett beslut att det skulle vara på engelska då flera av de externa integratörerna jobbade med utländska underleverantörer. Vi anser att det ska vara relativt enkelt att koppla de engelska begreppen med deras svenska fotbollsmotsvarigheter.

Felmeddelanden

HTTP 400 Bad Request:

  • Kontrollera obligatoriska parametrar.

  • Kontrollera datatyper.

  • Kontrollera format på datum och identifierare.

HTTP 401 Unauthorized:

  • Kontrollera att du använder rätt subscription key. Du hittar den i Profile i menyn uppe till höger och sedan Subscriptions - primary key och secondary key.

  • Kontrollera att nyckeln skickas med i rätt header - ApiKey.

HTTP 403 Forbidden:

  • Din användare eller prenumeration saknar behörighet till den aktuella produkten eller operationen.

HTTP 429 Too Many Requests:

  • Du har överskridit tillåtna anropsgränser. 60 anrop per minut, 1000 anrop per dygn.

HTTP 500 Internal Server Error:

  • Det betyder att ett oväntat fel inträffat i backend-systemet. Förse supporten med:

    • Tidpunkt

    • Endpoint

    • Correlation ID

    • Felmeddelande

Can I find the parts of the Swedish documentation translated to English?

At the moment, no.