Nástenka a novinky
Modul pre interné správy a oznámenia. Novinky sa zobrazujú na nástenke (dashboarde) a môžu byť kategorizované podľa tém.
Zoznam noviniek
GET /api/news
Oprávnenie: DASHBOARD_LIST
Filtre (query parametre):
| Parameter | Typ | Popis |
|---|---|---|
theme |
array | Zoznam ID tém na filtrovanie |
page |
integer | Číslo stránky |
per_page |
integer | Počet záznamov na stránku |
Odpoveď: Stránkovaný zoznam noviniek s prílohami.
Detail novinky
GET /api/news/{id}
Oprávnenie: DASHBOARD_LIST
Vráti detail novinky. Automaticky zaloguje, že používateľ si novinku pozrel.
Vytvorenie novinky
POST /api/news
Oprávnenie: NEWS_CREATE
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
enum_theme_id |
integer | áno | ID témy (z číselníka tém) |
title |
string | áno | Nadpis (max. 255 znakov) |
perex |
string | áno | Krátky popis / perex (max. 255 znakov) |
text |
string | áno | Plný text novinky |
Pripnutie / odopnutie novinky
PUT /api/news/{id}/pin
Oprávnenie: NEWS_PIN
Prepne stav pripnutia novinky. Pripnuté novinky sa zobrazujú na vrchu zoznamu.
Odpoveď:
{
"pin": true
}
Aktivita novinky (kto si ju pozrel)
GET /api/news/{id}/activity
Oprávnenie: NEWS_ACTIVITY_LIST
Vráti zoznam používateľov, ktorí si novinku pozreli, s časovými údajmi.
Zmazanie novinky
DELETE /api/news/{id}
Oprávnenie: NEWS_DELETE
Novinka sa soft-deletne (ostáva v databáze, ale nie je viditeľná).
Témy (číselník)
Zoznam tém
GET /api/enum/theme
Oprávnenie: DASHBOARD_LIST alebo ENUM_THEME_LIST
Vytvorenie témy
POST /api/enum/theme
Oprávnenie: ENUM_THEME_CREATE
Úprava témy
PUT /api/enum/theme/{id}
Oprávnenie: ENUM_THEME_UPDATE
Zmazanie témy
DELETE /api/enum/theme/{id}
Oprávnenie: ENUM_THEME_DELETE