API klíče

API klíč je heslo, kterým se k Simbile přihlašuje jiný program – vlastní aplikace, e-shop nebo automatizace. Klíče spravujete v menu Nastavení → API klíč, nebo odkazem Nastavení → API klíč.

Vytvoření klíče

1. Klikněte na Nový API klíč.
2. Do pole Poznámka napište, k čemu klíč bude – například „Klíč pro e-shop“. Poznámka je jediné, podle čeho klíč později poznáte.
3. V poli Účel nechte předvolenou hodnotu external – tou se označují klíče pro cizí aplikace. Hodnotu ui si přiděluje aplikace Simbily sama pro vlastní přihlášení; billing je vyhrazená pro fakturační propojení.
4. Klikněte na Vytvořit.

Celou hodnotu klíče uvidíte jen jednou, hned po vytvoření. Zkopírujte si ji tlačítkem vedle vypsaného klíče a uložte na bezpečné místo. Když ji ztratíte, zbývá jen klíč smazat a vytvořit nový.

Seznam klíčů

Tabulka ukazuje Poznámku, Účel, Uživatele, Klíč (posledních 8 znaků), Vytvořen a Naposledy použit. Podle posledního použití poznáte, jestli je klíč ještě k něčemu.

Ikona koše klíč smaže. Aplikace se zeptá Opravdu chcete smazat tento API klíč? Po smazání přestane okamžitě fungovat všechno, co ho používalo.

Kde se klíč používá

• V požadavcích na API jako hlavička Authorization: Bearer <klíč>.
• V bankovním napojení – klíč zadáte jako bezpečnostní token webhooku RaiffeisenBank Premium API, viz Nastavení bankovnictví.
• V PayMe – výzvy k platbě zakládají externí aplikace klíčem s účelem external, viz PayMe.

Bezpečnost

Klíč má stejný přístup k datům jako vy – zacházejte s ním jako s heslem. Nedávejte ho do veřejných repozitářů ani do e-mailu. Pro každou aplikaci vytvořte samostatný klíč, ať můžete zrušit jen ten jeden, když je potřeba.

Oznámení o událostech opačným směrem – tedy ze Simbily k vám – řeší webhooky.