KOSapi

h1. Studenti / studia

{{>toc}}

Jedna osoba může mít na ČVUT více souběžných studií, dokonce i v rámci jediné fakulty. Takoví studenti existují a ačkoli jde o minoritní případy, je nutné s nimi počítat.

h2. GET /students

Vrátí všechny studenty, které má fakulta právo vidět. To znamená všechny její studenty a studenty „cizích“ fakult, kteří mají zapsaný nějaký předmět z dané fakulty.

<warning>RSQL vyhledávání u tohoto zdroje zatím nefunguje, příčinou je chyba v KOSu.</warning>

* *URI:* {{base_url}}/api/3/students/
* *Typ zdroje:* Atom Feed
* *Typ obsahu:* [[Student]]
* *Formáty:* [[atom]], [[xml]]
* *Parametry:* [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#limit|limit]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]], [[URLParameters#offset|offset]], [[URLParameters#orderBy|orderBy]], [[URLParameters#query|query]]

h2. GET /students/{username}(-{order})

Vrátí _studium_ studenta podle jeho uživatelského jména a příp. pořadového čísla studia (řazeno od nejnovějšího), má-li více souběžných studií.

Příklad: Student s uživatelským jménem _flynnkev_ má tři aktivní souběžná studia. Potom jeho nejnovější studium (podle data vytvoření záznamu v KOS) bude mít identifikátor _flynnkev_, další _flynnkev-1_ a nejstarší studium _flynnkev-2_.

* *URI:* {{base_url}}/api/3/students/{username}/ | {{base_url}}/api/3/students/{username}-{order}/
* *Typ zdroje:* Atom Entry
* *Typ obsahu:* [[Student]]
* *Formáty:* [[atom]], [[xml]]
* *Proměnné:* @{username}@ uživatelské jméno, @{order}@ pořadové číslo aktivního studia
* *Parametry:* [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]]

h2. GET /students/{username}(-{order})/enrolledCourses

Vrátí zápisy předmětů daného studenta pro a) aktuální semestr, b) zvolené semestry parametrem [[URLParameters#sem|sem]], c) nebo pro všechny semestry (parametr _sem=none_).

* *URI:* {{base_url}}/api/3/students/{username}(-{order})/enrolledCourses/
* *Typ zdroje:* Atom Feed
* *Typ obsahu:* [[CourseEnrollee]] [[Parallel]]
* *Formáty:* [[atom]], [[xml]], [[text]]
* *Parametry:* [[URLParameters#sem|sem]], [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#limit|limit]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]], [[URLParameters#offset|offset]], [[URLParameters#orderBy|orderBy]], [[URLParameters#query|query]]

h2. GET /students/{username}(-{order})/parallels

Vrátí paralelky, na kterých je student zapsaný, pro a) aktuální semestr, b) zvolené semestry parametrem [[URLParameters#sem|sem]], c) nebo pro všechny semestry (parametr _sem=none_).

* *URI:* {{base_url}}/api/3/students/{username}(-{order})/parallels/
* *Typ zdroje:* Atom Feed
* *Typ obsahu:* [[Parallel]]
* *Formáty:* [[atom]], [[xml]]
* *Parametry:* [[URLParameters#sem|sem]], [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#limit|limit]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]], [[URLParameters#offset|offset]], [[URLParameters#orderBy|orderBy]], [[URLParameters#query|query]]