Guider & hjälp — fjellride.se

Tillbaka till Integrationer & API

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:

text
https://api.fjellride.se/api/v1

Interaktiv API-referens

Fullständig dokumentation med scheman, parametrar och testmöjligheter finns på:

text
https://api.fjellride.se/api/docs

Autentisering

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:

bash
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

KodBetydelse
400Felaktig förfrågan — validering misslyckades
401Ej autentiserad — saknad eller ogiltig autentisering
403Förbjuden — giltig auth men otillräckliga behörigheter
404Hittades inte — resursen finns inte
429Hastighetsbegränsad — vänta och försök igen
500Serverfel — något gick fel på vår sida