Endpoint 'ucebna'

Rozvrh NG » REST API pro export dat » Endpoint 'ucebna'

Tento endpoint exportuje rozvrhové lístky jedné učebny v daném časovém intervalu (podobně jako pohled Učebny - Podrobný). Exportují se všechny lístky kromě žádostí o rezervace a blokace studentských okruhů.

Pokud není žádná učebna vybraná, endpoint vrátí seznam všech budov a jejich učeben pro danou fakultu.

Endpoint nemá žádné doplňující salt-atributy (bezpečnostní token se sestaví přesně dle popisu REST API).

Endpoint má tyto rozšiřující parametry:

room - kód místnosti (PK z databáze)
fromjs - juliánské datum začátku požadovaného období
tojs - juliánské datum konce požadovaného období

Pokud není parametr room přítomen, skript vrátí seznam místností. Jinak vrátí rozvrhové lístky z dané místnosti v intervalu fromjs - tojs. Časový interval nesmí přesáhnout 1 rok (z kapacitních důvodů).

Pokud je vybrána místnost, výsledkem dotazu je JSON pole, které obsahuje objekty rozvrhových lístků. Každý RL objekt má následující atributy:

rl - ID lístku (RL z databáze); toto ID se může opakovat např. u pravidelné výuky, kde jeden lístek generuje jednu událost za každý týden
day - kalendářní den události
day_julian - kalendářní den jako juliánské datum
time - čas začátku výuky (počet minut od půlnoci daného dne)
length - délka výuky v minutách
caption - popisek RL (typicky název předmětu nebo popis rezervace)

Pokud má navíc zvolená fakulta zapnutý parametr rozvrhng.efa, vrátí se ve výsledku lístky všech fakult a u každého lístku přibude atribut fak obsahující kód fakulty lístku.

Struktura budov a místností je vrácena jako JSON pole budov, kde každá budova je objekt s následujícími atributy:

code - kód budovy (PK z databáze)
abbreviation - krátký název budovy
caption - dlouhý název (adresa)
rooms - pole místností dané budovy

Místnosti v poli rooms jsou reprezentovány opět objekty s atributy:

code - kód učebny(PK z databáze)
abbreviation - krátký název učebny
door - číslo dveří
description - dlouhý popis učebny
capacity - kapacita (max. počet posluchačů)
type - typ místnosti (V = veřejná, P = privátní)