SOURCE: Vacation Tracker TITLE: Jak korzystać z Open API? URL: https://vacationtracker.io/pl/baza-wiedzy/jak-korzystac-z-open-api/ LANG: pl PUBLISHED: 2026-10-06 UPDATED: 2026-11-02 READING: 4 min SUMMARY: Jak wygenerować klucz API w dodatku Open API i pobierać dane Vacation Tracker (użytkownicy, urlopy, lokalizacje, działy) do własnych systemów. # Jak korzystać z Open API? # Jak korzystać z Open API? Nasz dodatek Open API łączy Vacation Tracker z Twoimi własnymi narzędziami. Utwórz klucz API, wybierz, co może robić, i używaj go do odczytywania i zmieniania danych lub do otrzymywania powiadomień, gdy coś się zmieni. ### Obejrzyj samouczek Krótki przewodnik po dodatku Open API: ## Jak utworzyć klucz API - Zaloguj się do swojego konta Vacation Tracker na app.vacationtracker.io/signin (https://app.vacationtracker.io/signin). - Otwórz Integracje w menu po lewej stronie (w sekcji Ustawienia przestrzeni roboczej). - Kliknij kartę API. Otworzy się strona Open API. - W sekcji Klucze API kliknij Utwórz klucz API. - Wpisz Nazwę klucza. Tę nazwę widzą tylko osoby z Twojej firmy. - Opcjonalnie wpisz Nazwę integracji. Jest ona widoczna w Vacation Tracker przy każdej zmianie wprowadzonej przez klucz, na przykład „Zatwierdzone przez Jane (przez synchronizację płac)”. Pozostaw to pole puste, aby wyświetlać tylko imię i nazwisko osoby. - W sekcji Uprawnienia wybierz szablon i w razie potrzeby go dostosuj (zobacz poniżej). - W sekcji Wygaśnięcie wybierz, kiedy klucz wygaśnie: za 30 dni, za 90 dni, za 1 rok (zalecane) lub nigdy. - Sprawdź Podsumowanie i kliknij Utwórz klucz API. - Skopiuj klucz i przechowuj go w bezpiecznym miejscu. Pełny klucz jest wyświetlany tylko raz, w chwili utworzenia. ## Wybór uprawnień Zacznij od szablonu, a następnie go dostosuj: - Tylko odczyt: wgląd w dane bez możliwości zmian. Dobre do raportów i pulpitów. - Zarządzanie urlopami: składanie wniosków, dodawanie i zatwierdzanie urlopów. Odczyt użytkowników i typów urlopów. - Konfiguracja przestrzeni roboczej: konfigurowanie lokalizacji, działów, typów urlopów, polityk, świąt i użytkowników. - Niestandardowe: samodzielnie wybierasz każde uprawnienie. Każde uprawnienie można ustawić na Brak dostępu, Odczyt lub Odczyt i zapis. Zatwierdzanie i odrzucanie wniosków, wyświetlanie ukrytych nazw typów urlopów oraz działanie w imieniu innych użytkowników to osobne pola wyboru, więc włączaj je tylko wtedy, gdy Twoje narzędzie ich potrzebuje. Klucz może robić tylko to, na co Ty masz uprawnienia w Vacation Tracker. ## Zarządzanie kluczami Tabela Klucze API zawiera wszystkie klucze w Twojej przestrzeni roboczej wraz z ich właścicielem, uprawnieniami, ostatnim użyciem, datą wygaśnięcia i statusem. Kliknij klucz, aby otworzyć jego szczegóły, gdzie możesz: - Sprawdzić wykorzystanie w tym miesiącu oraz edytować nazwę i uprawnienia klucza. - Przejrzeć Ostatnią aktywność, czyli listę wszystkich żądań, które zmieniły dane. - Kliknąć Wymień klucz, aby otrzymać nowy klucz z tą samą nazwą i uprawnieniami. Wybierz, czy stary klucz ma działać jeszcze przez 24 godziny (zalecane), przez 7 dni, czy przestać działać od razu. - Kliknąć Unieważnij, aby trwale wyłączyć klucz. Wysyłamy Ci e-mail 14 dni przed wygaśnięciem klucza. ## Twoje pierwsze żądanie Bazowy adres URL to https://api.vacationtracker.io/v2. Wysyłaj klucz jako token typu bearer w nagłówku Authorization: curl https://api.vacationtracker.io/v2/departments \ -H "Authorization: Bearer vt_live_..." Udane wywołanie zwraca dane w polu data. Listy z kolejnymi stronami zawierają też nextToken, który przekazujesz z powrotem, aby pobrać następną stronę. { "data": [ ... ], "nextToken": "..." } Jeśli coś pójdzie nie tak, odpowiedź zawiera obiekt error z kodem, opisem i sposobem rozwiązania. Brakujący lub nieznany klucz zwraca kod 401. Klucz bez uprawnienia wymaganego przez żądanie zwraca kod 403 z INSUFFICIENT_SCOPE. Pełna dokumentacja techniczna Wszystkie endpointy, parametry, kody błędów i zdarzenia webhooków znajdziesz w naszej dokumentacji dla deweloperów (https://vacationtracker.io/developers/api-v2). Możesz ją też otworzyć przyciskiem Otwórz dokumentację na stronie dodatku Open API. ## Jak dodać webhook - Na stronie dodatku Open API przejdź do sekcji Webhooki i kliknij Zarządzaj webhookami. - Kliknij Dodaj webhook. - Wpisz Adres URL endpointu, który ma odbierać zdarzenia. Musi korzystać z protokołu HTTPS. - W sekcji Zdarzenia wybierz Decyzje urlopowe, Cała aktywność urlopowa, Pełna synchronizowana kopia lub Niestandardowe, aby samodzielnie wybrać zdarzenia. - Kliknij Dodaj webhook. Otrzymujesz zdarzenia tylko dotyczące danych, które możesz widzieć. ## Limity i ograniczenia szybkości Limity obowiązują dla każdego klucza API: - Do 30 000 żądań miesięcznie. - 10 żądań na sekundę, z możliwością chwilowego wzrostu do 50 żądań. Jeśli Twoja integracja potrzebuje więcej, napisz na adres developers@vacationtracker.io (mailto:developers@vacationtracker.io), podając nazwę firmy, integrację i spodziewany ruch. Starsze klucze API Klucze utworzone przed API v2 są wymienione w sekcji Starsze klucze (API v1). Nadal działają, ale mogą tylko odczytywać dane i nie działają z API v2. Aby zmieniać dane przez API, utwórz nowy klucz i skorzystaj z naszego przewodnika migracji (https://vacationtracker.io/developers/api-v2/migration). ## Najczęstsze pytania Czy powinienem korzystać z API, Zapiera czy serwera MCP? To zależy od tego, co chcesz zrobić. API służy do pracy z własnym kodem i narzędziami, a webhooki pozwalają reagować na zmiany. Zapier to opcja bez kodowania. Serwer MCP łączy narzędzie AI, takie jak Claude czy ChatGPT, dzięki czemu możesz zadawać pytania w języku naturalnym. Wiele zespołów korzysta z więcej niż jednej opcji. Czy API wiąże się z dodatkowymi kosztami? Nie. Dodatek Open API jest zawarty w planach Core i Complete bez dodatkowych opłat. Co zrobić, jeśli zgubię klucz? Pełny klucz jest wyświetlany tylko raz i nie można go odzyskać. Otwórz klucz i kliknij Wymień klucz, aby otrzymać nowy, a następnie zaktualizuj narzędzie, które z niego korzysta. Jeśli stary klucz mógł wyciec, wybierz opcję natychmiastowego wyłączenia. ### Co dalej? Jak połączyć Vacation Tracker z Zapier? (https://vacationtracker.io/pl/baza-wiedzy/jak-polaczyc-vacation-tracker-z-zapier/) Jak połączyć Vacation Tracker z narzędziami AI za pomocą serwera MCP? (https://vacationtracker.io/pl/baza-wiedzy/jak-polaczyc-vacation-tracker-z-narzedziami-ai-za-pomoca-serwera-mcp/) Jak wyeksportować raport wniosków urlopowych (historię urlopów)? (https://vacationtracker.io/pl/baza-wiedzy/jak-wyeksportowac-raport-wnioskow-urlopowych-historie-urlopow/) Potrzebujesz pomocy? Skontaktuj się z naszym zespołem wsparcia przez e-mail lub czat, od poniedziałku do piątku w godz. 9:00–17:00 (czas wschodnioamerykański, EST).