🔍 Co to je

Otevřené REST API pro integraci s dalšími systémy. Umožňuje číst i zapisovat data mezi Speyblem a jinými aplikacemi (např. mzdové systémy nebo interní nástroje).

🔑 Jak získat přístup

Žádné samoobslužné generování API klíčů v aplikaci není. Autentizace probíhá požadavkem POST /api/login s přihlašovacími údaji — odpověď vrátí bearer token a adresu vaší firemní subdomény. Všechny další požadavky směřují na subdoménu vašeho tenanta.

🧰 Co API umí

Veřejné API aktuálně pokrývá zhruba 38 operací:

  • Zaměstnanci — čtení, zápis, výpis

  • Docházka — vytvoření, úprava, smazání, schválení a zamítnutí záznamů

  • Typy docházky — výpis

  • Pozice a mzdy — pouze čtení

  • Plánování směn — správa přiřazení, generování a náhled rozvrhu

  • Exporty docházky — přehledy cílového odpracování (smlouvy CSV, dohody XLSX) a předvolby exportu

Dokumenty ani nábor zatím veřejné API nepokrývá — rozsah rozšiřujeme dle požadavků klientů.

📚 Dokumentace

Kompletní referenční dokumentaci najdete na adrese: api.speybl.com/api-documentation (včetně OpenAPI specifikace ke stažení).

✉️ Kontakt

Pokud vám některý endpoint chybí, napište na support@speybl.com.