API

Proč jsou Aplikace zastaralé

Aplikace jsou zastaralé. Pro nové projekty doporučujeme Hosting - Stacky. Stacky jsou modernější služba s AI-kompatibilním toolingem. Existující Aplikace zůstávají podporované.

Naše API je možné použít k vytváření, úpravě, zastavení nebo spouštění aplikací z vašich skriptů. To se vám bude hodit například při implementaci AB deploymentu nebo třeba při pravidelném zálohování.

Klíče pro přístup do API najdete v administraci v sekci Nastavení → API klíče. Můžete vytvořit více klíčů, každý popsat a nastavit mu datum expirace nebo platnost bez expirace. Celá hodnota nového klíče se zobrazí jen jednou; později lze klíč pouze zneplatnit.

Každé integraci vytvořte vlastní klíč. Jeho zneplatnění potom neovlivní ostatní integrace. rosticli login si při autorizaci vytváří vlastní klíč automaticky a lze jej zneplatnit ve stejné sekci.

API klíč má oprávnění uživatele, kterému patří. Seznam firem vracený přes GET /api-n/companies (v MCP nástroj list_companies) obsahuje pouze firmy, jejichž je uživatel členem, a to i pro superuživatele. Běžný uživatel, včetně uživatele s příznakem staff, má přístup pouze k těmto firmám. Superuživatel může navíc otevřít přímý odkaz z podpory a spravovat prostředky jiné firmy bez členství; může také převést vlastníka firmy na jejího stávajícího člena. Takto otevřená firma se v nové administraci dočasně zobrazí v přepínači firem s poznámkou „Tuto firmu vidíte, protože jste superuživatel.“ Po přepnutí na jinou firmu z nabídky zmizí. Pro operace použijte skutečné ID vybrané firmy v cestě URL. ID prostředku samo o sobě přístup neuděluje a musí odpovídat vybrané firmě. Hodnota company_id=0 je starší režim pro vybrané globální přehledy superuživatele, nikoli náhrada skutečného ID firmy pro všechny operace.

Dokumentace k API je oddělená od této dokumentace, protože je generovaná společně se změnami v kódu a najdete ji na adrese https://admin.rosti.cz/api-n/docs.

Staré API už není ve vývoji a nové služby do něj nebudeme přidávat.

Přechod na Stacky a dřívější samostatné VM

Stacky se spravují přes rozhraní Stacků v administraci, REST API a MCP. Nabídka profilů patří ke Stackům. Po nasazení nové verze administrace určené pro službu podporující pouze Stacky už tato rozhraní neposkytují dřívější samostatné VM, jejich seznam ani profily; původní URL vracejí chybu 404. ID samostatného VM nelze použít místo ID Stacku. Existující Aplikace zůstávají podporované.

V této nové verzi přehled rušené společnosti zahrnuje také Stacky, které se teprve připravují. Společnost lze odstranit až po potvrzení, že už nemá žádné Stacky. Pokud se nepodaří ověřit seznam prostředků nebo dokončit jejich odstranění, společnost zůstane zachována.

Přihlašování a starší klíče

Původní klíč uložený u účtu se automaticky přesune mezi API klíče s popisem Legacy API key. Jeho hodnota se nemění, takže existující integrace fungují dál. Ve stejné sekci jej můžete zneplatnit. Každé nové přihlášení heslem, e-mailovým odkazem nebo passkey vydává samostatný token prohlížeče s expirací, který spravujete v seznamu přihlášených zařízení. Zneplatnění tokenu používaného prohlížečem vás odhlásí; znovu se přihlaste.

REST API i MCP přijímají tyto hlavičky:

X-API-Key: TOKEN
Authorization: Bearer TOKEN
Authorization: Token TOKEN

Použijte jednu z uvedených variant. Pokud pošlete obě hlavičky, má přednost X-API-Key, i když obsahuje neplatný nebo prázdný klíč.