Přeskočit na hlavní obsah

Lze volat evidenci přehledů v API?

Jak zjistit ID přehledu a jakou adresou jej otevřít

Autor: Petr Pech

Přehledy (dashboardy) lze vyvolat vzdáleně — nejde ale o datové volání REST API, nýbrž o otevření webového rozhraní na adrese konkrétního přehledu.


Zjištění ID přehledu

Přehledy jsou v evidenci dashboard-panel, takže si jejich seznam vytáhnete přes API:

GET /c/{firma}/dashboard-panel.xml?detail=custom:id,kod,nazev

Odpověď obsahuje interní číslo i kód každého přehledu, například DEFAULT-STATUS (Základní přehled) nebo OBRATY (Odběratelé). Totéž najdete v aplikaci ve správě přehledů.


Výsledná adresa

https://{server}:5434/c/{firma}/app/?authSessionId={token}&inDesktopApp=true#/dashboard/{ID}?lang=cs

Význam jednotlivých částí:

Část adresy

Význam

{firma}

Strojový identifikátor firmy.

authSessionId

Autentizační token — jak jej získat, popisuje článek Vygenerování autentizačního tokenu.

{ID}

Interní číslo přehledu z evidence dashboard-panel.

lang

Jazyk rozhraní, cs nebo en.

⚠️ Token v adrese se zapisuje do logů serveru. Používáte-li tuto adresu jen k otevření přehledu v prohlížeči, je to přijatelné; pro datové volání API je bezpečnější hlavička X-authSessionId.

ℹ️ Samotná data přehledu takto nezískáte — vrací se webová stránka. Potřebujete-li čísla, sáhněte po příslušné evidenci nebo účetních výstupech, viz Účetní stavy a pohyby.


Související

Dostali jste odpověď na svou otázku?