REST API i klucze API
Dokumentacja API opisuje endpointy aplikacji: logowanie, rejestrację czasu pracy, obecności i raporty. Do integracji serwer–serwer administrator generuje w panelu klucze API. Kluczem (nagłówek X-Api-Key) odczytasz obecności, czyli sesje pracy pracowników z wybranego dnia lub zakresu dat. Każdy klucz wyłączysz jednym kliknięciem, bez wpływu na pozostałe.
Klucze API
Nazwa, uprawnienia, opcjonalna data ważności i data ostatniego użycia. Pełny klucz widzisz tylko raz, w bazie trzymamy jego skrót.
Dokumentacja API
Lista endpointów z opisem na publicznej stronie dokumentacji.
Webhook zdarzeń
Pracownik zaczął lub skończył pracę? Złożył wniosek urlopowy? Wysyłamy POST na Twój adres.
Eksporty dla działu płac
Zamiast przepisywać godziny z arkusza, pobierasz gotowy plik za miesiąc i przekazujesz go księgowości albo wczytujesz do programu płacowego.
Eksport CSV (PL i CZ)
Dla każdego pracownika: dni i godziny pracy, nadgodziny, przerwy, dni urlopu i chorobowego. Otworzysz go w Excelu lub zaimportujesz do programu, który przyjmuje CSV.
Eksport do PREMIER (CZ)
Plik dla czeskiego programu płacowego PREMIER. Kody składników płacowych ustawiasz dla swojej firmy, a przed pobraniem widzisz podgląd z ostrzeżeniami.
Raporty XLSX i PDF
Raport okresowy w XLSX i miesięczny raport PDF z ewidencją czasu pracy każdego pracownika.
Webhook — powiadomienie w chwili zdarzenia
Zamiast co chwilę odpytywać API, możesz podać w ustawieniach adres HTTPS swojego systemu. TimeHunter wysyła na niego żądanie POST z danymi w JSON, gdy pracownik zaczyna lub kończy pracę, zaczyna lub kończy przerwę, składa wniosek urlopowy albo gdy wniosek zostanie rozpatrzony. Każde zdarzenie wysyłamy raz, więc jeśli Twój system nie może żadnego zgubić, uzupełnij webhook okresowym odczytem przez API.
6 typów zdarzeń
work_start, work_stop, break_start, break_end, leave_request_created, leave_request_status.
Tylko HTTPS
Adres musi używać HTTPS, a adresy sieci wewnętrznych są blokowane.
Test z panelu
W ustawieniach wyślesz testowe zdarzenie i sprawdzisz, czy Twój serwer je odbiera.
Przykłady zastosowań
Obecności we własnym systemie
Sesje pracy z wybranego okresu odczytane kluczem API zasilają Twój system płacowy lub ERP.
Tablica obecności w biurze
Zdarzenia rozpoczęcia i końca pracy z webhooka aktualizują ekran w recepcji lub na hali.
Reakcja na zdarzenia
Webhook o nowym wniosku urlopowym uruchamia proces w Twoim systemie, bez odpytywania API.
Najczęściej zadawane pytania
Czy klucze API są w każdym planie?
Czy webhook jest ponawiany, gdy mój serwer nie odpowie?
Czy mogę zrobić własny eksport dla nietypowego programu kadrowego?
Wypróbuj 14 dni za darmo
Rozpocznij 14-dniowy okres testowy. Bez karty kredytowej, pełna funkcjonalność.