Napojení na API
API propojí Lunchdrive s dalšími systémy – docházkou, mzdovým programem nebo vlastní aplikací. Propojený systém se do Lunchdrive hlásí API klíčem, který si vytvoříte sami. Co všechno API umí, popisuje dokumentace API Lunchdrive.
API klíče si vytváří provozovatel a správce klienta (firmy).
Kde API klíče najdete
- Provozovatel: Správa účtu → v levém menu API klíče.
- Klient: Správa účtu → API klíče. Když tam položku nevidíte, váš účet má změny nastavení vypnuté – obraťte se na svou jídelnu, případně na podporu Lunchdrive.
V seznamu vidíte jen klíče, které jste vytvořili vy. Klíč totiž patří tomu, kdo ho vytvořil, a propojený systém s ním v Lunchdrive pracuje s jeho oprávněními.
Vytvoření nového klíče
-
Klikněte na Vytvořit nový API klíč.
-
Do pole Popis napište, k čemu klíč slouží, třeba „Docházka Giriton“. Až budete mít klíčů víc, poznáte podle popisu, který je který.
-
Klikněte na Vytvořit.
-
Okno teď ukáže celý klíč. Klikněte na Kopírovat a klíč vložte do propojeného systému.
-
Zavřete okno tlačítkem Klíč mám zkopírovaný, zavřít.
Pozor
Celý klíč uvidíte jen jednou, v tomhle okně. Po jeho zavření ho v Lunchdrive už nezobrazíte – v seznamu zůstane jen jeho začátek a konec. Kdo klíč zná, dostane se k datům vašeho účtu se stejnými oprávněními jako vy. Vložte ho proto jen do systému, který ho potřebuje, a neposílejte ho e-mailem ani v chatu.
Co uvidíte v seznamu
- Popis – k čemu klíč slouží.
- API klíč – jen první a poslední čtyři znaky, třeba
a1b2…9f0e. Podle nich poznáte, který klíč je vložený ve kterém systému. - Vytvořeno – kdy jste klíč vytvořili.
- Naposledy použito – kdy s klíčem naposledy něco volalo API. „—“ znamená, že ještě nikdy. Čas se zapisuje nejvýš jednou za 5 minut, takže u systému, který volá často, může být o pár minut pozadu.
Klíč jste ztratili nebo se dostal ven
Znovu zobrazit ho nejde. Udělejte si nový:
- Vytvořte nový klíč podle postupu výše.
- V propojeném systému nahraďte starý klíč novým.
- Starý klíč v seznamu smažte tlačítkem Odstranit a potvrďte. Od té chvíle s ním API nikoho nepustí.
Tip
Nevíte, jestli starý klíč ještě něco používá? Po výměně koukněte za pár minut do sloupce Naposledy použito. Když u nového klíče přibyl čas, propojený systém už jede na něm.