KOSapi

h1. Vyučující

{{>toc}}

*Rozsah dat:* omezený / záznamy pro danou fakultu *[[data_restrictions|/?/]]*

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/id-123456).

* *URI:* {{base_url}}/api/3/teachers/{username} | {{base_url}}/api/3/teachers/id-{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_, _role_, 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-{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, role, [[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]]