SOURCE: Vacation Tracker TITLE: Hur använder jag OpenAPI? URL: https://vacationtracker.io/sv/kunskapsbas/hur-anvander-jag-openapi/ LANG: sv PUBLISHED: 2026-10-06 UPDATED: 2026-11-02 READING: 4 min SUMMARY: Så skapar du en API-nyckel i tillägget Öppet API, väljer behörigheter och läser eller ändrar data i Vacation Tracker, plus webhooks, kvoter och hastighetsbegränsningar. # Hur använder jag OpenAPI? # Hur använder jag OpenAPI? Vårt tillägg Öppet API kopplar Vacation Tracker till dina egna verktyg. Skapa en API-nyckel, välj vad den får göra och använd den för att läsa och ändra dina data eller få aviseringar när något ändras. ### Titta på genomgången En kort genomgång av tillägget Öppet API: ## Så skapar du en API-nyckel - Logga in på ditt Vacation Tracker-konto på app.vacationtracker.io/signin (https://app.vacationtracker.io/signin). - Öppna Integrationer i menyn till vänster (under Arbetsplatsinställningar). - Klicka på kortet API. Då öppnas sidan Öppet API. - Klicka på Skapa API-nyckel i avsnittet API-nycklar. - Ange ett Nyckelnamn. Bara personer i ditt företag ser det här namnet. - Ange vid behov ett Integrationsnamn. Det visas i Vacation Tracker bredvid varje ändring som nyckeln gör, till exempel ”Godkänd av Jane (via Payroll sync)”. Lämna fältet tomt om bara personens namn ska visas. - Under Behörigheter väljer du en mall och justerar den vid behov (se nedan). - Under Utgång väljer du när nyckeln ska upphöra att gälla: om 30 dagar, om 90 dagar, om 1 år (rekommenderas) eller aldrig. - Kontrollera Sammanfattning och klicka på Skapa API-nyckel. - Kopiera nyckeln och förvara den på ett säkert ställe. Hela nyckeln visas bara en gång, när den skapas. ## Välja behörigheter Börja med en mall och justera den sedan: - Endast läsning: se data, ändra ingenting. Passar för rapporter och instrumentpaneler. - Ledighetshantering: begär, lägg till och godkänn ledigheter. Läs användare och ledighetstyper. - Konfiguration av arbetsytan: ställ in platser, avdelningar, ledighetstyper, policyer, helgdagar och användare. - Anpassad: välj varje behörighet själv. Varje behörighet kan ställas in på Ingen åtkomst, Läsa eller Läsa och skriva. Att godkänna och neka ansökningar, se dolda namn på ledighetstyper och agera för andra användares räkning är separata kryssrutor, så aktivera dem bara om ditt verktyg behöver dem. En nyckel kan bara göra det som du själv får göra i Vacation Tracker. ## Hantera dina nycklar Tabellen API-nycklar listar alla nycklar i arbetsytan med ägare, behörigheter, senaste användning, utgångsdatum och status. Klicka på en nyckel för att öppna dess detaljer, där du kan: - Se månadens användning och redigera nyckelns namn och behörigheter. - Kontrollera Senaste aktivitet, som listar alla förfrågningar som har ändrat data. - Klicka på Rotera nyckel för att få en ny nyckel med samma namn och behörigheter. Välj om den gamla nyckeln ska fortsätta fungera i 24 timmar (rekommenderas), i 7 dagar eller sluta fungera direkt. - Klicka på Återkalla för att stoppa nyckeln permanent. Vi skickar ett e-postmeddelande till dig 14 dagar innan en nyckel upphör att gälla. ## Gör din första förfrågan Bas-URL:en är https://api.vacationtracker.io/v2. Skicka din nyckel som en bearer-token i headern Authorization: curl https://api.vacationtracker.io/v2/departments \ -H "Authorization: Bearer vt_live_..." Ett lyckat anrop returnerar data under data. Listor med fler sidor innehåller också en nextToken, som du skickar tillbaka för att hämta nästa sida. { "data": [ ... ], "nextToken": "..." } Om något går fel innehåller svaret ett error med en kod, en beskrivning och en lösning. En nyckel som saknas eller är okänd returnerar 401. En nyckel som saknar den behörighet som en förfrågan kräver returnerar 403 med INSUFFICIENT_SCOPE. Fullständig teknisk referens Alla endpoints, parametrar, felkoder och webhook-händelser finns i vår utvecklardokumentation (https://vacationtracker.io/developers/api-v2). Du kan också öppna den med knappen Öppna dokumentation på sidan för tillägget Öppet API. ## Så lägger du till en webhook - Gå till Webhooks på sidan för tillägget Öppet API och klicka på Hantera webhooks. - Klicka på Lägg till webhook. - Ange den Endpoint-URL som ska ta emot händelserna. Den måste använda HTTPS. - Under Händelser väljer du Ledighetsbeslut, All aktivitet kring ledighet, Håll en fullständig kopia synkroniserad eller Anpassad för att välja händelser själv. - Klicka på Lägg till webhook. Du får bara händelser för data som du har behörighet att se. ## Kvoter och hastighetsbegränsningar Begränsningarna gäller per API-nyckel: - Upp till 30 000 förfrågningar per månad. - 10 förfrågningar per sekund, med tillfälliga toppar på upp till 50 förfrågningar. Om din integration behöver mer skickar du ett e-postmeddelande till developers@vacationtracker.io (mailto:developers@vacationtracker.io) med ditt företagsnamn, integrationen och den trafik du räknar med. Äldre API-nycklar Nycklar som skapades före API v2 listas under Äldre nycklar (API v1). De fortsätter att fungera, men de kan bara läsa data och fungerar inte med API v2. Om du vill ändra data via API:et skapar du en ny nyckel och följer vår migreringsguide (https://vacationtracker.io/developers/api-v2/migration). ## Vanliga frågor Ska jag använda API:et, Zapier eller MCP-servern? Det beror på vad du vill göra. API:et är till för din egen kod och dina egna verktyg, med webhooks för att reagera på ändringar. Zapier är alternativet utan kod. MCP-servern kopplar ett AI-verktyg som Claude eller ChatGPT, så att du kan ställa frågor med vanligt språk. Många team använder mer än ett av alternativen. Kostar API:et extra? Nej. Tillägget Öppet API ingår i planerna Core och Complete utan extra kostnad. Vad händer om jag tappar bort en nyckel? Hela nyckeln visas bara en gång och kan inte återställas. Öppna nyckeln och klicka på Rotera nyckel för att få en ny, och uppdatera sedan verktyget som använder den. Om den gamla nyckeln kan ha läckt väljer du att stoppa den direkt. ### Nästa steg Hur kopplar jag Vacation Tracker till Zapier? (https://vacationtracker.io/sv/kunskapsbas/hur-kopplar-jag-vacation-tracker-till-zapier/) Hur kopplar jag Vacation Tracker till mina AI-verktyg med MCP-servern? (https://vacationtracker.io/sv/kunskapsbas/hur-kopplar-jag-vacation-tracker-till-mina-ai-verktyg-med-mcp-servern/) Hur exporterar jag en rapport över ledighetsansökningar (ledighetshistorik)? (https://vacationtracker.io/sv/kunskapsbas/hur-exporterar-jag-en-rapport-over-ledighetsansokningar-ledighetshistorik/) Behöver du hjälp? Kontakta vårt supportteam via e-post eller chatt, måndag till fredag kl. 9–17 (EST).