REST API z kluczami i limitami
Każda akcja w TimeHunter (utworzenie sesji, akceptacja urlopu, eksport raportu) ma swój endpoint REST API. Klucze API generujesz w panelu admina — z osobnym scope (read-only / full-access) i osobnym limitem (np. 1000 zapytań / godz). Każdy klucz może być wyłączony jednym klikiem, bez wpływu na pozostałe.
Klucze API z scope
Każdy klucz: nazwa, uprawnienia, limit zapytań, data ważności, audit log.
Rate limiting per klucz
Konfigurowalny: od 100/h do 10000/h. Zwracamy nagłówki X-RateLimit-Remaining.
Webhooks zdarzeń
Pracownik rozpoczął sesję? Zaakceptowano urlop? My wysyłamy POST na Twój URL.
OAuth 2.0 + audit
Logowanie usług trzecich przez OAuth. Każde wywołanie API w audit logu z IP.
Eksport kadrowy do PL + CZ programów
Eksport godzin per pracownik w formacie zgodnym z najpopularniejszymi programami kadrowo-płacowymi w Polsce i Czechach. Bez przepisywania, bez konwertowania, bez ryzyka błędu w wypłatach.
🇵🇱 Polska: Comarch Optima, Symfonia, enova365, Sage
Format XLS/CSV zgodny z importerem każdego z programów.
🇨🇿 Czechy: Pohoda, Money S3, Helios, ABRA, FlexiBee
Eksport XML/CSV dla każdego z 5 popularnych programów czeskich.
Webhooks — Twój system dostaje powiadomienie w sekundę
Klasyczne integracje polegają na pollingu („sprawdź co minutę czy coś się zmieniło"). To strata zasobów i opóźnienia. TimeHunter wysyła webhooki — POST request na Twój URL w momencie zdarzenia. Lista zdarzeń: rozpoczęcie sesji, zakończenie, akceptacja urlopu, odrzucenie wniosku, przekroczenie limitu nadgodzin, alert compliance.
15 typów zdarzeń
Session start/stop, leave requested/approved/rejected, overtime warning, compliance violation, employee created.
Podpisy HMAC SHA-256
Każdy webhook ma nagłówek X-Signature — weryfikujesz że wysłany przez TimeHunter, nie przez atakującego.
Retry z exponential backoff
Twój endpoint zwrócił 5xx? Ponawiamy 5× (1m, 5m, 25m, 2h, 8h). Dead-letter queue dostępne w panelu.
Realne use case-y integracji
Klienci TimeHunter łączą system z różnymi narzędziami — od Slacka po SAP HR. Najczęstsze scenariusze: (1) automatyczne ogłoszenie na Slack gdy ktoś idzie na urlop; (2) push godzin do Comarch Optima na koniec miesiąca przez API; (3) sync grafiku do Google Calendar zespołu; (4) eksport godzin per projekt do JIRA / Asana / Trello.
Slack / MS Teams
Webhook → post na kanał #zespol „Anna idzie na urlop 15-20 czerwca".
Google Calendar / Outlook
OAuth integracja, sync grafiku i urlopów do kalendarza zespołu.
JIRA / Asana / Trello
Pull godzin per task — wpinasz w Twoje sprint reporty.
SAP HR / Workday
Enterprise integracje przez REST API + SFTP. Dedicated account manager.
SDK i sandbox dla developerów
TimeHunter API ma kompletną dokumentację OpenAPI 3.0 (Swagger UI), sandbox z testowymi danymi, SDK w 3 językach (PHP, Node.js, Python) i przykłady kodu w Go, Rust, Java. Każdy endpoint ma działający curl example. Developer instaluje SDK npm-em i ma kompletny klient w 5 minut.
Najczęściej zadawane pytania
Czy API jest darmowe w każdym planie?
Czy macie SDK w PHP/Node.js/Python?
Czy webhook retry jest wbudowany?
Czy mogę zrobić własny eksport dla nietypowego programu kadrowego?
Czy obsługujecie OAuth 2.0 / SSO?
Czy API zwraca dane w PLN czy CZK?
Wypróbuj 14 dni za darmo
Rozpocznij 14-dniowy okres testowy. Bez karty kredytowej, pełna funkcjonalność.