KOSapi

h1. Semestry

{{>toc}}

*Rozsah dat:* úplný / záznamy pro celé ČVUT *[[data_restrictions|/?/]]*

h2. GET /semesters

Vrátí všechny semestry.

* *URI:* {{base_url}}/api/3/semesters/
* *Typ zdroje:* Atom Feed
* *Typ obsahu:* [[Semester]]
* *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 /semesters/{code}

Vrátí konkrétní semestr podle jeho [[SemesterFilter|KOSího kódu]].

* *URI:* {{base_url}}/api/3/semesters/{code}
* *Typ zdroje:* Atom Entry
* *Typ obsahu:* [[Semester]]
* *Formáty:* [[atom]], [[xml]]
* *Proměnné:* @{code}@ kód semestru
* *Parametry:* [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]]

h2. GET /semesters/current

Vrátí aktuální semestr, ve kterém probíhá výuka (v KOS parametr _AKTSEM)_.

* *URI:* {{base_url}}/api/3/semesters/current
* *Typ zdroje:* Atom Entry
* *Typ obsahu:* [[Semester]]
* *Formáty:* [[atom]], [[xml]], [[text]]
* *Parametry:* [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]]

h2. GET /semesters/next

Vrátí příští semestr, tj. následující po aktuálním (v KOS parametr _PRISEM)_.

* *URI:* {{base_url}}/api/3/semesters/next
* *Typ zdroje:* Atom Entry
* *Typ obsahu:* [[Semester]]
* *Formáty:* [[atom]], [[xml]], [[text]]
* *Parametry:* [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]]

h2. GET /semesters/prev

Vrátí předchozí semestr – druhý aktuální ve kterém lze klasifikovat (v KOS parametr _AKTSEM2)_.

* *URI:* {{base_url}}/api/3/semesters/prev
* *Typ zdroje:* Atom Entry
* *Typ obsahu:* [[Semester]]
* *Formáty:* [[atom]], [[xml]], [[text]]
* *Parametry:* [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]]

h2. GET /semesters/scheduling

Vrátí semestr, ve kterém probíhají zápisy do rozvrhu (v KOS parametr _SEMPROROZ)_.

* *URI:* {{base_url}}/api/3/semesters/scheduling
* *Typ zdroje:* Atom Entry
* *Typ obsahu:* [[Semester]]
* *Formáty:* [[atom]], [[xml]], [[text]]
* *Parametry:* [[URLParameters#fields|fields]], [[URLParameters#lang|lang]], [[URLParameters#locEnums|locEnums]], [[URLParameters#multilang|multilang]]