Students » Historie » Verze 9
« Předchozí -
Verze 9/11
(rozdíl) -
Další » -
Aktuální verze
Jakub Jirůtka, 2014-11-10 18:51
přidána možnost identifikovat studenta i podle ID
Studenti / studia¶
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.
Rozsah dat: omezený / záznamy pro danou fakultu /?/
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.
- URI: https://kosapi.fit.cvut.cz/api/3/students/
- Typ zdroje: Atom Feed
- Typ obsahu: Student
- Formáty: atom, xml
- Parametry: fields, lang, limit, locEnums, multilang, offset, orderBy, query
GET /students/{studyCodeOrId}¶
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í, nebo podle jeho databázového ID.
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: https://kosapi.fit.cvut.cz/api/3/students/{username}(-{order}/ | https://kosapi.fit.cvut.cz/api/3/students/{id: [0-9]+}/
- 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: fields, lang, locEnums, multilang
GET /students/{studyCodeOrId}/enrolledCourses¶
Vrátí zápisy předmětů daného studenta pro a) aktuální semestr, b) zvolené semestry parametrem sem, c) nebo pro všechny semestry (parametr sem=none).
- URI: https://kosapi.fit.cvut.cz/api/3/students/{username}(-{order}/enrolledCourses/ | https://kosapi.fit.cvut.cz/api/3/students/{id: [0-9]+}/enrolledCourses/
- Typ zdroje: Atom Feed
- Typ obsahu: CourseEnrollment
- Formáty: atom, xml, text
- Parametry: sem, fields, lang, limit, locEnums, multilang, offset, orderBy, query
GET /students/{studyCodeOrId}/parallels¶
Vrátí paralelky, na kterých je student zapsaný, pro a) aktuální semestr, b) zvolené semestry parametrem sem, c) nebo pro všechny semestry (parametr sem=none).
- URI: https://kosapi.fit.cvut.cz/api/3/students/{username}(-{order}/parallels/ | https://kosapi.fit.cvut.cz/api/3/students/{id: [0-9]+}/parallels/
- Typ zdroje: Atom Feed
- Typ obsahu: Parallel
- Formáty: atom, xml
- Parametry: sem, fields, lang, limit, locEnums, multilang, offset, orderBy, query
GET /students/{studyCodeOrId}/registeredExams¶
Vrátí zápisy zkoušek daného studenta pro a) aktuální semestr, b) zvolené semestry parametrem sem, c) nebo pro všechny semestry (parametr sem=none).