users
Popis Uživatelé - Spojení mezi externím uživatelským jménem a identitami v IS/STAG.
Typ REST
Adresa /ws/services/rest2/users
Specifikace
Název users

Operace

activateStagUser
Garance Garantováno minimálně do 28.3.2025
Komentář Aktivuje nebo deaktivuje uživatelské konto.
HTTP metoda GET
Adresa /ws/services/rest2/users/activateStagUser
Možné výstupní MIME typy application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Oblasti root
Je nutné ověřování přihlášení, ověření dle uživatelské role
Povolené role AD (Administrátor)
Parametry
Název Typ (Java) Komentář
stagUser String
stagUserNameForUpdate String Uživatelské jméno, u kterého provést změnu.
stavAktivace String Aktivovat (A) ci zneplatnit (N) dane uzivatelske konto?

deleteStagUser
Garance Garantováno minimálně do 28.3.2025
HTTP metoda GET
Adresa /ws/services/rest2/users/deleteStagUser
Možné výstupní MIME typy application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Oblasti root
Je nutné ověřování přihlášení, ověření dle uživatelské role
Povolené role AD (Administrátor)
Parametry
Název Typ (Java) Komentář
stagUser String
stagUserNameForDelete String

getExternalLoginByOsobniCislo
Garance Garantováno minimálně do 28.3.2025
Komentář Vrátí externí login studenta podle jeho osobního čísla. Může vrátit prázdný řetězec - student nemusí mít externí login.
HTTP metoda GET
Adresa /ws/services/rest2/users/getExternalLoginByOsobniCislo
Možné výstupní MIME typy text/plain
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
osCislo String

getExternalLoginByUcitIdno
Garance Garantováno minimálně do 28.3.2025
Komentář Vrátí externí login učitele na základě STAGovského ID (ucitIdno).
HTTP metoda GET
Adresa /ws/services/rest2/users/getExternalLoginByUcitIdno
Možné výstupní MIME typy text/plain
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
ucitIdno Long STAG ID učitele (ucitIdno).

getFotoOsoby
Garance Garantováno minimálně do 28.3.2025
Komentář Vrati fotku osoby podle osobIdno. Funguje pouze na skolach, kde je fotka fyzicky ulozena v IS/STAG (tabulka OSOBY_FOTO).
HTTP metoda GET
Adresa /ws/services/rest2/users/getFotoOsoby
Možné výstupní MIME typy */*
Oblasti root, downloads
Je nutné ověřování přihlášení, ověření dle uživatelské role
Povolené role PR (Prorektor)
AD (Administrátor)
Parametry
Název Typ (Java) Komentář
stagUser String
osobIdno Long

getKalendarOsoby
Garance Garantováno minimálně do 28.3.2025
Komentář Vrátí rozvrh osoby na podle jejího externího loginu (pripadne podle jejiho linku vygenerovaneho v portalu), ve formátu iCAL (např. po GoogleCalendar). Pokud má osoba více identit (student i učitel, více os. čísel..), vrací všechny identity dohromady. Pro studenta vrací rozvrh jeho předmětů plus termíny zkoušek, na kterých je/byl přihlášen, pro vyučujícího rozvrh jím vyučovaných předmětů a termínů jím zkoušených zkoušek
HTTP metoda GET
Adresa /ws/services/rest2/users/getKalendarOsoby
Možné výstupní MIME typy text/calendar
Oblasti root, downloads
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
login String Externí login uživatele nebo speciální link uživatele vygenerovaný v portálu (přístup přes orion login bude brzy omezen)
rokOd Long
rokDo Long
semestr String Semestr. Není-li uveden, berou se oba semestry
lang String

getOsoba
Garance Garantováno minimálně do 28.3.2025
Komentář Vrati osobu z tabulky OSOBY zadanou PRAVE jednim ze svych identifikatoru (osobIdno, osCislo, rodCislo).
HTTP metoda GET
Adresa /ws/services/rest2/users/getOsoba
Možné výstupní MIME typy application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Oblasti root
Je nutné ověřování přihlášení, ověření dle uživatelské role
Povolené role PR (Prorektor)
AD (Administrátor)
SP (Spec. referentka)
SR (Studijní referentka)
Parametry
Název Typ (Java) Komentář
stagUser String
osobIdno Long
osCislo String
rodCislo String

getOsobniCislaByExternalLogin
Garance Garantováno minimálně do 28.3.2025
Komentář Vrátí seznam osobních čísel studenta dle jeho zadaného externího loginu.
HTTP metoda GET
Adresa /ws/services/rest2/users/getOsobniCislaByExternalLogin
Možné výstupní MIME typy application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
login String Externí login studenta
pouzeStudujici Boolean Je-li true (defaultne), vraci pouze aktualne studujici nebo prerusena studia. Je-li false, vraci vsechny

getStagUserForStagLogin
Garance Garantováno minimálně do 28.3.2025
Komentář Vrátí informaci o roli uživatele dle jeho zadaného IS/STAG loginu.
HTTP metoda GET
Adresa /ws/services/rest2/users/getStagUserForStagLogin
Možné výstupní MIME typy application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
login String IS/STAG login uživatele

getStagUserListForExternalLogin
Garance Garantováno minimálně do 28.3.2025
Komentář Vrátí seznam IS/STAG rolí uživatele dle jeho zadaného externího loginu.
HTTP metoda GET
Adresa /ws/services/rest2/users/getStagUserListForExternalLogin
Možné výstupní MIME typy application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
externalLogin String Externí login uživatele

getStagUserListForExternalLoginV2
Garance Garantováno minimálně do 28.3.2025
Komentář Vrátí seznam IS/STAG rolí uživatele dle jeho zadaného externího loginu.
HTTP metoda GET
Adresa /ws/services/rest2/users/getStagUserListForExternalLoginV2
Možné výstupní MIME typy application/xml, text/xml, application/json, text/yaml
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
externalLogin String Externí login uživatele

getStagUsersRoles
Garance Garantováno minimálně do 28.3.2025
Komentář Vrací seznam uživatelů a jejich rolí v IS/STAG dle zadané fakulty, katedry a dalších parametrů. Uživatelé s rolí fakulta mohou vidět jen svoji fakultu, uživatelé s rolí katedra jen svoji katedru.
HTTP metoda GET
Adresa /ws/services/rest2/users/getStagUsersRoles
Možné výstupní MIME typy application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Oblasti root
Je nutné ověřování přihlášení, ověření dle uživatelské role
Povolené role PR (Prorektor)
AD (Administrátor)
KA (Katedra)
FA (Tajemník fakulty)
Parametry
Název Typ (Java) Komentář
stagUser String
fakulta String
katedra String
idRole String

getUcitIdnoByExternalLogin
Garance Garantováno minimálně do 28.3.2025
Komentář Vrátí STAGovské ID učitele (ucitIdno) na základě externího uživatelského jména učitele.
HTTP metoda GET
Adresa /ws/services/rest2/users/getUcitIdnoByExternalLogin
Možné výstupní MIME typy text/plain
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
externalLogin String Externí login učitele.

insertOsoba
Garance Garantováno minimálně do 28.3.2025
Komentář Vlozi do systemu novou osobu. Vraci zpet informace o teto osobe plus vyplnene osobidno (ktere databaze generuje sama). Neni-li zadano rodne cislo, vygeneruje se pseudorodny kod podle data narozeni a pohlavi.
HTTP metoda POST
Adresa /ws/services/rest2/users/insertOsoba
Možné výstupní MIME typy */*
Oblasti root
Je nutné ověřování přihlášení, ověření dle uživatelské role
Povolené role PR (Prorektor)
AD (Administrátor)
SP (Spec. referentka)
SR (Studijní referentka)
Parametry
Název Typ (Java) Komentář
stagUser String
osoba WSOsobaBean

insertStagUser
Garance Garantováno minimálně do 28.3.2025
HTTP metoda POST
Adresa /ws/services/rest2/users/insertStagUser
Možné výstupní MIME typy */*
Oblasti root
Je nutné ověřování přihlášení, ověření dle uživatelské role
Povolené role AD (Administrátor)
Parametry
Název Typ (Java) Komentář
stagUser String
stagUserForInsert WSStagUserForEdit

kalendar
Garance Garantováno minimálně do 28.3.2025
Komentář Vrátí rozvrh osoby na podle jejího externího loginu (pripadne podle jejiho linku vygenerovaneho v portalu), ve formátu iCAL (např. po GoogleCalendar). Pokud má osoba více identit (student i učitel, více os. čísel..), vrací všechny identity dohromady. Pro studenta vrací rozvrh jeho předmětů plus termíny zkoušek, na kterých je/byl přihlášen, pro vyučujícího rozvrh jím vyučovaných předmětů a termínů jím zkoušených zkoušek
HTTP metoda GET
Adresa /ws/services/rest2/users/kalendar/{link}
Možné výstupní MIME typy */*
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
arg0 String Speciální link uživatele vygenerovaný v portálu

kalendar2
Garance Negarantováno! Pozor, tato služa je sice na IS/STAG API přítomna, ale její přesná specifikace a funkčnost není jakkoliv garantována a její použití je zcela na riziko klienta. Služba se může kdykoliv bez varování změnit či zmizet.
HTTP metoda GET
Adresa /ws/services/rest2/users/kalendar/{link}/{anything}
Možné výstupní MIME typy */*
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
arg0 String Speciální link uživatele vygenerovaný v portálu
arg1 String

kalendarHead
Garance Negarantováno! Pozor, tato služa je sice na IS/STAG API přítomna, ale její přesná specifikace a funkčnost není jakkoliv garantována a její použití je zcela na riziko klienta. Služba se může kdykoliv bez varování změnit či zmizet.
HTTP metoda HEAD
Adresa /ws/services/rest2/users/kalendar/{link}
Možné výstupní MIME typy */*
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
arg0 String Speciální link uživatele vygenerovaný v portálu

kalendarHead2
Garance Negarantováno! Pozor, tato služa je sice na IS/STAG API přítomna, ale její přesná specifikace a funkčnost není jakkoliv garantována a její použití je zcela na riziko klienta. Služba se může kdykoliv bez varování změnit či zmizet.
HTTP metoda HEAD
Adresa /ws/services/rest2/users/kalendar/{link}/{anything}
Možné výstupní MIME typy */*
Oblasti root
Je nutné ověřování pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele)
Parametry
Název Typ (Java) Komentář
arg0 String Speciální link uživatele vygenerovaný v portálu
arg1 String

updateOsoba
Garance Garantováno minimálně do 28.3.2025
Komentář Upravi zaznam v tabulce OSOBY. Upravuje pouze ty polozky, jejichz hodnota byla predana (tj. neni prazdna nebo null).
HTTP metoda POST
Adresa /ws/services/rest2/users/updateOsoba
Možné výstupní MIME typy */*
Oblasti root
Je nutné ověřování přihlášení, ověření dle uživatelské role
Povolené role PR (Prorektor)
AD (Administrátor)
SP (Spec. referentka)
SR (Studijní referentka)
Parametry
Název Typ (Java) Komentář
stagUser String
osoba WSOsobaBean