API

Prístup k dokumentácii nájdete tu: Swagger.

Prehľad zmien v novej verzii ALITEO API (ver. 25.1.)

Nižšie nájdete krátke zhrnutie noviniek a zmien vykonaných v rámci novej verzie ALITEO API.

Nové endpointy

• apiAddTimesheet (implementovaný ako POST /timesheets/add) Tento endpoint umožňuje pridať nový výkaz práce (timesheet) pre konkrétneho používateľa v spoločnosti. Slúži na evidenciu odpracovaného času vrátane detailov, ako je zdroj výkazu, popis alebo časový rozsah.

Úpravy existujúcich endpointov

• apiAddTask Pridaný nový parameter emailowner. Umožňuje pri zakladaní úlohy určiť vlastníka pomocou jeho e-mailu, čo je užitočné napríklad pri zadávaní úlohy anonymným používateľom cez e-mailovú integráciu.

• apiAddUserCompany a apiModifyUserCompany Odstránený parameter supervisorm. Bol odstránený, pretože táto možnosť už v aplikácii neexistuje a nie je naďalej podporovaná.

• apiDataMemberProject Odstránené parametre canaddgroups, management a supervisorm. Tieto roly už nie sú v aplikácii využívané – ich funkcionalita bola zjednodušená alebo zlúčená. Pridaný nový parameter planner. Tento parameter určuje, či má používateľ rolu plánovača – plánovač môže kapacitne plánovať úlohy projektu, čo prináša lepšiu kontrolu nad časovým rozvrhnutím práce.

• ApiDataMemberTeam Odstránené parametre canaddgroups, management a supervisorm. Rovnako ako pri projekte boli tieto roly z aplikácie odstránené, pretože sa už nepoužívajú alebo boli nahradené.

• apiDataTeam Pridané nové parametre phases a taskattributes. Tieto rozšírenia súvisia s prepracovaním štruktúry tímov – tímy teraz môžu definovať vlastné stavy a atribúty úloh podľa svojich potrieb.

• apiList* Pridaný parameter listType, ktorý umožňuje zvoliť formát výstupu – buď ako jednoduché pole ID (ArrayWithIds), alebo ako pole objektov obsahujúcich ID a názov (ArrayWithNames). Táto zmena dáva možnosť vybrať si medzi klasickým výstupom v podobe poľa ID alebo prehľadným výpisom aj s názvami.

• apiResultList* Pridaný parameter items typu apiResultListItem[], ktorý sa používa pri voľbe ArrayWithNames z predchádzajúceho kroku. Výsledkom je, že volanie API teraz môže priamo vracať nielen ID objektov, ale aj ich názvy – čo výrazne zjednodušuje prácu s výstupom a eliminuje potrebu ďalších volaní na iný endpoint kvôli získaniu názvov.

Prístup k dokumentácii nájdete tu: Swagger.