REST API s klíči a limity
Každá akce v TimeHunter (vytvoření relace, schválení dovolené, export reportu) má svůj REST API endpoint. API klíče vygenerujete v admin panelu — s vlastním scope (read-only / full-access) a vlastním limitem (např. 1000 dotazů / hod). Každý klíč lze deaktivovat jedním klikem, bez vlivu na ostatní.
API klíče se scope
Každý klíč: název, oprávnění, limit dotazů, datum platnosti, audit log.
Rate limiting na klíč
Konfigurovatelný: od 100/h do 10000/h. Vracíme hlavičky X-RateLimit-Remaining.
Webhooks událostí
Zaměstnanec spustil relaci? Schválena dovolená? Pošleme POST na váš URL.
OAuth 2.0 + audit
Přihlášení třetích služeb přes OAuth. Každé volání API v audit logu s IP.
Mzdový export do PL + CZ programů
Export hodin per zaměstnanec ve formátu kompatibilním s nejpopulárnějšími mzdovými programy v Polsku a Česku. Bez přepisování, bez konverzí, bez rizika chyb ve výplatách.
🇵🇱 Polsko: Comarch Optima, Symfonia, enova365, Sage
XLS/CSV formát kompatibilní s importérem každého programu.
🇨🇿 Česko: Pohoda, Money S3, Helios, ABRA, FlexiBee
XML/CSV export pro každý z 5 populárních českých programů.
Webhooks — váš systém dostane upozornění za sekundu
Klasické integrace jsou na pollingu („zkontroluj každou minutu, jestli se něco změnilo"). Plýtvání a zpoždění. TimeHunter posílá webhooky — POST request na váš URL v okamžiku události. Seznam: spuštění relace, ukončení, schválení dovolené, zamítnutí žádosti, překročení limitu přesčasů, compliance alert.
15 typů událostí
Session start/stop, leave requested/approved/rejected, overtime warning, compliance violation, employee created.
HMAC SHA-256 podpisy
Každý webhook má hlavičku X-Signature — ověřujete, že poslal TimeHunter, ne útočník.
Retry s exponential backoff
Váš endpoint vrátil 5xx? Opakujeme 5× (1m, 5m, 25m, 2h, 8h). Dead-letter queue v panelu.
Reálné integrační use case-y
Zákazníci TimeHunter propojují systém s různými nástroji — od Slacku po SAP HR. Nejčastější scénáře: (1) automatické oznámení na Slack při dovolené; (2) push hodin do Pohody na konci měsíce přes API; (3) sync rozvrhu do Google Calendar týmu; (4) export hodin per projekt do JIRA / Asana / Trello.
Slack / MS Teams
Webhook → post na kanál #tym „Anna jde na dovolenou 15-20 června".
Google Calendar / Outlook
OAuth integrace, sync rozvrhu a dovolených do kalendáře týmu.
JIRA / Asana / Trello
Pull hodin per task — zapojíte do svých sprint reportů.
SAP HR / Workday
Enterprise integrace přes REST API + SFTP. Dedikovaný account manager.
SDK a sandbox pro vývojáře
TimeHunter API má kompletní OpenAPI 3.0 dokumentaci (Swagger UI), sandbox s testovacími daty, SDK ve 3 jazycích (PHP, Node.js, Python) a ukázky kódu v Go, Rust, Java. Každý endpoint má funkční curl example. Vývojář instaluje SDK přes npm a má kompletního klienta za 5 minut.
Často kladené otázky
Je API zdarma v každém plánu?
Máte SDK v PHP/Node.js/Pythonu?
Je webhook retry vestavěný?
Mohu si udělat vlastní export pro neobvyklý mzdový program?
Podporujete OAuth 2.0 / SSO?
Vrací API data v CZK nebo PLN?
Vyzkoušet 14 dní zdarma
Začněte 14denní zkušební dobu. Bez karty, plná funkcionalita.