Začínáme

onDuty API v1 je veřejné REST rozhraní nad plánováním směn a QR docházkou. Umožňuje číst i zapisovat zaměstnance, prodejny, směny, pípnutí, docházkové dny, žádosti o volno, uzávěrky měsíce a mzdové podklady - a přihlásit se k odběru událostí přes webhooky.

1. Získej API klíč

API klíče spravuje centrála v portálu, sekce API. Klíč se zobrazí v plném znění JEN JEDNOU při vytvoření - ulož si ho hned, později ho z bezpečnostních důvodů nejde znovu zobrazit.

2. První volání

Seznam prodejen tvého subjektu:

curl https://www.onduty.cz/api/v1/stores \
  -H "Authorization: Bearer sk_live_..."

Odpověď je vždy JSON ve tvaru { ok: true, data } nebo { ok: false, error } - viz Chyby.

3. Další kroky

• Autentizace - scopes, rate limit, idempotence, stránkování.
• Koncepty - směna vs. pípnutí vs. pracovní den, časové zóny, uzávěrka měsíce.
• Webhooky - odběr událostí v reálném čase, ověření podpisu.
• API reference - kompletní seznam endpointů se schématy (OpenAPI 3.1).
• AI a vaše data - jak funguje AI asistent a MCP, potvrzovací brána nad zápisy, audit a EU AI Act.