API

Přístup k API dokumentaci naleznete zde: Swagger.

Přehled změn v nové verzi ALITEO API (ver. 25.1.)

Nové endpointy

• apiAddTimesheet
  (implementovaný jako POST /timesheets/add)
  Tento endpoint umožňuje přidat nový výkaz práce (timesheet) pro konkrétního uživatele ve společnosti. Slouží k evidenci odpracovaného času včetně detailů, jako je zdroj výkazu, popis nebo časový rozsah.

Úpravy existujících endpointů

• apiAddTask
  Přidán nový parametr emailowner.
  Umožňuje při zakládání úkolu určit vlastníka pomocí jeho e-mailu, což je užitečné například při zadání úkolu anonymním uživatelem přes e-mailovou integraci.

• apiAddUserCompany a apiModifyUserCompany
  Odstraněn parametr supervisorm.
  Byl odstraněn, protože tato možnost již v aplikaci neexistuje a není nadále podporována.

• apiDataMemberProject
  Odstraněny parametry canaddgroups, management a supervisorm.
  Tyto role již nejsou v aplikaci využívány – jejich funkčnost byla zjednodušena nebo sloučena.
  Přidán nový parametr planner. Tento parametr určuje, zda má uživatel roli plánovače – plánovač může kapacitně plánovat úkoly projektu, což přináší lepší kontrolu nad časovým rozvržením práce.

• ApiDataMemberTeam
  Odstraněny parametry canaddgroups, management a supervisorm.
  Stejně jako u projektu byly tyto role z aplikace odstraněny, protože se již nepoužívají nebo byly nahrazeny.

• apiDataTeam
  Přidány nové parametry phases a taskattributes.
  Tato rozšíření souvisí s přepracováním struktury týmů – nyní mohou týmy definovat vlastní stavy a atributy úkolů podle svých potřeb.

• apiList*
  Přidán parametr listType, který umožňuje zvolit formát výstupu – buď jako jednoduché pole ID (ArrayWithIds), nebo jako pole objektů obsahujících ID a název (ArrayWithNames).
  Tato změna dává možnost si vybrat, klasický výstup v podobě pole IDs nebo přehledný výčet i s názvy.

• apiResultList*
  Přidán parametr items typu apiResultListItem[], který je používán při volbě ArrayWithNames z předchozího kroku.
  Výsledkem je, že volání API nyní může rovnou vracet jak ID objektů, tak jejich názvy – což výrazně zjednodušuje práci s výstupem a eliminuje potřebu dalších volání na jiný endpoint kvůli názvům.

Více k API na tomto odkazu.