KOSapi

h1. Vyučující

{{>toc}}

h2. GET /teachers

Vrátí všechny vyučující.

* *URI:* {{base_url}}/api/3/teachers/

* *Typ zdroje:* Atom Feed

* *Typ obsahu:* [[Teacher]]

* *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 /teachers/{usernameOrId}

Vrátí vyučujícího podle jeho loginu nebo ID (např. teachers/123456).

* *URI:* {{base_url}}/api/3/teachers/{username} | {{base_url}}/api/3/teachers/{id: [0-9]+}

* *Typ zdroje:* Atom Entry

* *Typ obsahu:* [[Teacher]]

* *Formáty:* [[atom]], [[xml]]

* *Proměnné:* @{username}@ uživatelské jméno | @{id}@ ID vyučujícího

* *Parametry:* [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]]

h2. GET /teachers/{usernameOrId}/courses

Vrátí předměty, které vyučující přednáší, cvičí, zkouší nebo garantuje v a) v aktuálním semestru, b) ve zvolených semestrech parametrem [[URLParameters#sem|sem]]. Výběr lze dále omezit podle role vyučujícího v daném předmět parametrem _roles_, který přijímá hodnoty _lecturer, instructor, examiner, guarantor, editor_ nebo jejich kombinace oddělené čárkami (ve významu _nebo_).

* *URI:* {{base_url}}/api/3/teachers/{username}/courses | {{base_url}}/api/3/teachers/{id: [0-9]+}/courses

* *Typ zdroje:* Atom Feed

* *Typ obsahu:* [[Course]]

* *Formáty:* [[atom]], [[xml]]

* *Proměnné:* @{username}@ uživatelské jméno | @{id}@ ID vyučujícího

* *Parametry:* roles, [[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 /teachers/{usernameOrId}/parallels

Vrátí paralelky, které vyučující přednáší nebo cvičí 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/teachers/{username}/parallels | {{base_url}}/api/3/teachers/{id: [0-9]+}/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]]

h2. GET /teachers/{usernameOrId}/exams

Vrátí zkoušky, které vyučující vypsal 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/teachers/{username}/exams | {{base_url}}/api/3/teachers/{id: [0-9]+}/exams

* *Typ zdroje:* Atom Feed

* *Typ obsahu:* [[Exam]]

* *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]]

h2. GET /teachers/{usernameOrId}/timetable

Vrátí tzv. „omezení vyučujícího“ pro a) aktuální semestr, b) zvolené semestry parametrem [[URLParameters#sem|sem]], c) nebo pro všechny semestry (parametr _sem=none_). Jde o časové sloty v rozvrhu, které si vyučující rezervuje na jiné akce než výuku předmětu (např. konzultační hodiny, účast na jednáních výzkumné skupiny apod.) Slouží především jako informace pro rozvrháře.

* *URI:* {{base_url}}/api/3/teachers/{username}/timetable | {{base_url}}/api/3/teachers/{id: [0-9]+}/timetable

* *Typ zdroje:* Atom Feed

* *Typ obsahu:* [[TeacherTimetableSlot]]

* *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]]