Students » Historie » Verze 6

Jakub Jirůtka, 2012-08-07 11:10
RSQL vyhledávání nad /students už je funkční

1 1 Jakub Jirůtka
h1. Studenti / studia
2 1 Jakub Jirůtka
3 1 Jakub Jirůtka
{{>toc}}
4 1 Jakub Jirůtka
5 1 Jakub Jirůtka
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.
6 1 Jakub Jirůtka
7 1 Jakub Jirůtka
8 1 Jakub Jirůtka
h2. GET /students
9 1 Jakub Jirůtka
10 1 Jakub Jirůtka
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.
11 1 Jakub Jirůtka
12 1 Jakub Jirůtka
* *URI:* {{base_url}}/api/3/students/
13 1 Jakub Jirůtka
* *Typ zdroje:* Atom Feed
14 1 Jakub Jirůtka
* *Typ obsahu:* [[Student]]
15 1 Jakub Jirůtka
* *Formáty:* [[atom]], [[xml]]
16 1 Jakub Jirůtka
* *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]]
17 1 Jakub Jirůtka
18 1 Jakub Jirůtka
19 1 Jakub Jirůtka
h2. GET /students/{username}(-{order})
20 1 Jakub Jirůtka
21 1 Jakub Jirůtka
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í. 
22 1 Jakub Jirůtka
23 1 Jakub Jirůtka
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_.
24 1 Jakub Jirůtka
25 1 Jakub Jirůtka
* *URI:* {{base_url}}/api/3/students/{username}/ | {{base_url}}/api/3/students/{username}-{order}/
26 1 Jakub Jirůtka
* *Typ zdroje:* Atom Entry
27 1 Jakub Jirůtka
* *Typ obsahu:* [[Student]]
28 1 Jakub Jirůtka
* *Formáty:* [[atom]], [[xml]]
29 1 Jakub Jirůtka
* *Proměnné:* @{username}@ uživatelské jméno, @{order}@ pořadové číslo aktivního studia
30 1 Jakub Jirůtka
* *Parametry:* [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]]
31 3 Jakub Jirůtka
32 3 Jakub Jirůtka
33 3 Jakub Jirůtka
h2. GET /students/{username}(-{order})/enrolledCourses
34 3 Jakub Jirůtka
35 3 Jakub Jirůtka
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_).
36 3 Jakub Jirůtka
37 3 Jakub Jirůtka
* *URI:* {{base_url}}/api/3/students/{username}(-{order})/enrolledCourses/
38 3 Jakub Jirůtka
* *Typ zdroje:* Atom Feed
39 5 Jakub Jirůtka
* *Typ obsahu:* [[CourseEnrollment]]
40 3 Jakub Jirůtka
* *Formáty:* [[atom]], [[xml]], [[text]]
41 3 Jakub Jirůtka
* *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]]
42 3 Jakub Jirůtka
43 3 Jakub Jirůtka
44 3 Jakub Jirůtka
h2. GET /students/{username}(-{order})/parallels
45 3 Jakub Jirůtka
46 3 Jakub Jirůtka
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_).
47 3 Jakub Jirůtka
48 3 Jakub Jirůtka
* *URI:* {{base_url}}/api/3/students/{username}(-{order})/parallels/
49 3 Jakub Jirůtka
* *Typ zdroje:* Atom Feed
50 3 Jakub Jirůtka
* *Typ obsahu:* [[Parallel]]
51 3 Jakub Jirůtka
* *Formáty:* [[atom]], [[xml]]
52 3 Jakub Jirůtka
* *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]]