Varování: Původní REST rozhraní již není do budoucna udržitelné a nebude nadále rozvíjeno. Přejděte se svými aplikacemi na nové REST rozhraní. Detailní informace a harmonogram přechodu naleznete na této stránce.

users
Description Uživatelé - Spojení mezi externím uživatelským jménem a identitami v IS/STAG.
Type REST_OLD
Address /ws/services/rest/users
Specifikace
Title users

Operation

activateStagUser
Comment Aktivuje nebo deaktivuje uživatelské konto.
HTTP metoda GET
Adresa /ws/services/rest/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
Areas root
Authentication necessary log in, authenticate with user role
Permitted roles AD (Administrator)
Arguments
Title Type (Java) Comment
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
HTTP metoda GET
Adresa /ws/services/rest/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
Areas root
Authentication necessary log in, authenticate with user role
Permitted roles AD (Administrator)
Arguments
Title Type (Java) Comment
stagUser String
stagUserNameForDelete String

getExternalLoginByOsobniCislo
Comment 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/rest/users/getExternalLoginByOsobniCislo
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
Areas root
Authentication necessary without logging in
Arguments
Title Type (Java) Comment
osCislo String

getExternalLoginByUcitIdno
Comment Vrátí externí login učitele na základě STAGovského ID (ucitIdno).
HTTP metoda GET
Adresa /ws/services/rest/users/getExternalLoginByUcitIdno
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
Areas root
Authentication necessary without logging in
Arguments
Title Type (Java) Comment
ucitIdno Long STAG ID učitele (ucitIdno).

getKalendarOsoby
Comment Vrátí rozvrh osoby na podle jejího externího loginu, 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/rest/users/getKalendarOsoby
Možné výstupní MIME typy text/calendar
Areas root
Authentication necessary without logging in
Arguments
Title Type (Java) Comment
login String Externí login uživatele
rokOd Long
rokDo Long
semestr String Semestr. Není-li uveden, berou se oba semestry
lang String

getOsoba
Comment Vrati osobu z tabulky OSOBY zadanou PRAVE jednim ze svych identifikatoru (osobIdno, osCislo, rodCislo).
HTTP metoda GET
Adresa /ws/services/rest/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
Areas root
Authentication necessary log in, authenticate with user role
Permitted roles PR (Vice-Rector)
AD (Administrator)
SR (Study Office Secretary)
Arguments
Title Type (Java) Comment
stagUser String
osobIdno Long
osCislo String
rodCislo String

getOsobniCislaByExternalLogin
Comment Vrátí seznam osobních čísel studenta dle jeho zadaného externího loginu.
HTTP metoda GET
Adresa /ws/services/rest/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
Areas root
Authentication necessary without logging in
Arguments
Title Type (Java) Comment
login String Externí login studenta
pouzeStudujici Boolean Je-li true (defaultne), vraci pouze aktualne studujici nebo prerusena studia. Je-li false, vraci vsechny

getStagUserForStagLogin
Comment Vrátí informaci o roli uživatele dle jeho zadaného IS/STAG loginu.
HTTP metoda GET
Adresa /ws/services/rest/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
Areas root
Authentication necessary without logging in
Arguments
Title Type (Java) Comment
login String IS/STAG login uživatele

getStagUserListForExternalLogin
Comment Vrátí seznam IS/STAG rolí uživatele dle jeho zadaného externího loginu.
HTTP metoda GET
Adresa /ws/services/rest/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
Areas root
Authentication necessary without logging in
Arguments
Title Type (Java) Comment
externalLogin String Externí login uživatele

getStagUsersRoles
Comment 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/rest/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
Areas root
Authentication necessary log in, authenticate with user role
Permitted roles PR (Vice-Rector)
AD (Administrator)
KA (Department)
FA (Faculty Secretary)
Arguments
Title Type (Java) Comment
stagUser String
fakulta String
katedra String
idRole String

getUcitIdnoByExternalLogin
Comment 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/rest/users/getUcitIdnoByExternalLogin
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
Areas root
Authentication necessary without logging in
Arguments
Title Type (Java) Comment
externalLogin String Externí login učitele.

insertOsoba
Comment 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/rest/users/insertOsoba
Možné výstupní MIME typy */*
Areas root
Authentication necessary log in, authenticate with user role
Permitted roles PR (Vice-Rector)
AD (Administrator)
SR (Study Office Secretary)
Arguments
Title Type (Java) Comment
stagUser String
osoba WSOsobaBean

insertStagUser
HTTP metoda POST
Adresa /ws/services/rest/users/insertStagUser
Možné výstupní MIME typy */*
Areas root
Authentication necessary log in, authenticate with user role
Permitted roles AD (Administrator)
Arguments
Title Type (Java) Comment
stagUser String
stagUserForInsert WSStagUserForEdit

updateOsoba
Comment Upravi zaznam v tabulce OSOBY. Upravuje pouze ty polozky, jejichz hodnota byla predana (tj. neni prazdna nebo null).
HTTP metoda POST
Adresa /ws/services/rest/users/updateOsoba
Možné výstupní MIME typy */*
Areas root
Authentication necessary log in, authenticate with user role
Permitted roles PR (Vice-Rector)
AD (Administrator)
SR (Study Office Secretary)
Arguments
Title Type (Java) Comment
stagUser String
osoba WSOsobaBean