API klíče a přihlášení

Jak vytvořit API klíč, jaký přístup zvolit, jak přihlásit CLI a jak API klíč zneplatnit.

Vytvoření API klíče

Otevřete Nastavení → API a CLI.
Klikněte na Vytvořit API klíč a vyplňte název (třeba „Export do tabulky“), přístup a platnost.
API klíč si hned zkopírujte. Moniary si ukládá jen jeho otisk, takže vám ho už znovu neukáže.

API klíč začíná na mny_ a posílá se v hlavičce požadavku:

Authorization: Bearer mny_…

Přístup

Přístup	Co API klíč smí
Čtení	Jen akce, které čtou data. Nic nezmění.
Čtení a zápis	Navíc nahrávat, upravovat, vystavovat a odesílat doklady a párovat platby.

Když API klíč spustí akci, na kterou nemá přístup, dostane chybu 403 INSUFFICIENT_SCOPE. Pro přehledy, exporty a AI agenty, kteří jen odpovídají na otázky, použijte API klíč pro čtení.

Komu API klíč patří

API klíč jedná vaším jménem, a to jen ve firmě, ve které jste ho vytvořili. Pro jinou firmu si vytvořte další API klíč.
Má vždy stejná oprávnění jako vy. Když se změní vaše role, změní se i to, co API klíč smí.
Když z firmy odejdete, API klíč přestane fungovat.
Každý vidí a spravuje jen své API klíče. V jedné firmě můžete mít nejvýš 20 aktivních API klíčů.

Přihlášení CLI

Příkaz moniary login otevře prohlížeč. Přihlaste se, vyberte firmu a přístup a klikněte na Povolit přístup. CLI si pak vytvoří vlastní API klíč s názvem „CLI (název počítače)“. Uvidíte ho v seznamu API klíčů a zneplatníte ho stejně jako ostatní. Víc na stránce CLI.

Přihlášení používá OAuth s PKCE. Prohlížeč předá jednorázový kód jen CLI na vašem počítači (127.0.0.1). Kód platí 10 minut a dá se použít jen jednou.

Zneplatnění

U API klíče v seznamu klikněte na Zneplatnit. API klíč přestane fungovat okamžitě. Pokud API klíč unikne, třeba do repozitáře, zneplatněte ho a vytvořte si nový.

Bezpečnost

API klíč nevkládejte do kódu ani do prohlížeče. Uložte ho do proměnné prostředí nebo do správce hesel a tajných údajů.
Pro každý skript nebo službu si vytvořte samostatný API klíč s jasným názvem. Ve sloupci Poslední použití pak uvidíte, které API klíče se ještě používají.
API klíčům pro jednorázové úlohy nastavte platnost 30 nebo 90 dní.