Courses » Historie » Verze 1
Verze 1/12
-
Další » -
Aktuální verze
Jakub Jirůtka, 2011-06-26 01:19
Předměty¶
Rozlišují se dvě entity předmětu - předmět (course) a tzv. instance předmětu (coursin). První obsahuje všechny statické údaje předmětu jako je název, způsob zakončení, anotace, osnovy apod. Tyto údaje by měly být po dobu existence předmětu neměnné. Instance předmětu je pak konkrétní instance vypsaná v semestru (tzv. „semestropředmět“) a obsahuje proměnné údaje jako je kapacita, počet obsazených míst apod.
GET /courses¶
Vrátí všechny předměty.
- URI: https://kosapi.fit.cvut.cz/api/3/courses/
- Typ zdroje: Atom Feed
- Typ obsahu: Course
- Formáty: atom, xml
- Parametry: fields, lang, multilang, locEnums, startIndex, maxResults, orderBy, query
GET /courses/{code}¶
Vrátí konkrétní předmět podle jeho kódu.
- URI: https://kosapi.fit.cvut.cz/api/3/courses/{code}
- Typ zdroje: Atom Entry
- Typ obsahu: Course
- Formáty: atom, xml
- Proměnné:
{code}
kód předmětu - Parametry: fields, lang, multilang, locEnums
GET /courses/{code}/texts¶
Vrátí texty daného předmětu (anotace, osnovy apod.)
Pozn.: Získání těchto dat je databázově poměrně drahé, proto jsou odděleny do samostatného zdroje.
- URI: https://kosapi.fit.cvut.cz/api/3/courses/{code}/texts
- Typ zdroje: Atom Entry
- Typ obsahu: CourseTexts
- Formáty: atom, xml
- Proměnné:
{code}
kód oboru - Parametry: fields, lang, multilang
Instance předmětů¶
GET /courses/{code}/instances¶
Vrátí všechny instance daného předmětu.
- URI: https://kosapi.fit.cvut.cz/api/3/courses/{code}/instances/
- Typ zdroje: Atom Feed
- Typ obsahu: Coursin
- Formáty: atom, xml
- Parametry: fields, lang, multilang, locEnums
GET /courses/{code}/instances/{semester}¶
Vrátí danou instanci předmětu podle jeho kódu a semestru.
- URI: https://kosapi.fit.cvut.cz/api/3/courses/{code}/instances/{semester}
- Typ zdroje: Atom Entry
- Typ obsahu: Coursin
- Formáty: atom, xml
- Proměnné:
{code}
kód předmětu, @{semester} kód semestru - Parametry: fields, lang, multilang, locEnums
GET /courses/{code}/instances/{semester}/examiners/¶
Vrátí zkoušející tohoto předmětu v daném semestru.
- URI: https://kosapi.fit.cvut.cz/api/3/courses/{code}/instances/{semester}/examiners/
- Typ zdroje: Atom Feed
- Typ obsahu: Teacher
- Formáty: atom, xml
- Proměnné:
{code}
kód předmětu, @{semester} kód semestru - Parametry: fields, lang, multilang, locEnums
GET /courses/{code}/instances/{semester}/guarantors/¶
Vrátí garanty tohoto předmětu v daném semestru.
- URI: https://kosapi.fit.cvut.cz/api/3/courses/{code}/instances/{semester}/guarantors/
- Typ zdroje: Atom Feed
- Typ obsahu: Teacher
- Formáty: atom, xml
- Proměnné:
{code}
kód předmětu, @{semester} kód semestru - Parametry: fields, lang, multilang, locEnums
GET /courses/{code}/instances/{semester}/instructors/¶
Vrátí cvičící tohoto předmětu v daném semestru.
- URI: https://kosapi.fit.cvut.cz/api/3/courses/{code}/instances/{semester}/instructors/
- Typ zdroje: Atom Feed
- Typ obsahu: Teacher
- Formáty: atom, xml
- Proměnné:
{code}
kód předmětu, @{semester} kód semestru - Parametry: fields, lang, multilang, locEnums
GET /courses/{code}/instances/{semester}/lecturers/¶
Vrátí přednášející tohoto předmětu v daném semestru.