Använda Fjellride API
Bas-URL, autentisering, organisationskontext, felhantering och allt du behöver för ditt första API-anrop.
Kom igång med API:et
Fjellride API låter dig hantera produkter, bokningar, platser och mer programmatiskt. Det är ett REST API som returnerar JSON och använder versionerade sökvägar.
Bas-URL
Alla API-anrop använder följande bas-URL:
https://api.fjellride.se/api/v1Interaktiv API-referens
Fullständig dokumentation med scheman, parametrar och testmöjligheter finns på:
https://api.fjellride.se/api/docsAutentisering
API-nycklar (rekommenderat för integrationer)
API-nycklar är det primära sättet att autentisera server-till-server-förfrågningar. Skapa dem från Inställningar → API-nycklar i din instrumentpanel.
Skicka nyckeln i x-api-key-headern:
curl -X GET https://api.fjellride.se/api/v1/products \
-H "x-api-key: fjr_din_api_nyckel"Organisationskontext
Varje API-förfrågan verkar inom en specifik organisation. Med API-nyckel bestäms organisationen automatiskt. Om din nyckel har åtkomst till flera organisationer, ange vilken med x-organization-id-headern.
Svar och felhantering
Lyckade svar returnerar JSON med 200, 201 eller 204 statuskoder.
Vanliga statuskoder
| Kod | Betydelse |
|---|---|
400 | Felaktig förfrågan — validering misslyckades |
401 | Ej autentiserad — saknad eller ogiltig autentisering |
403 | Förbjuden — giltig auth men otillräckliga behörigheter |
404 | Hittades inte — resursen finns inte |
429 | Hastighetsbegränsad — vänta och försök igen |
500 | Serverfel — något gick fel på vår sida |