soubory
Description	Soubory v IS/STAG
Type	REST
Address	/ws/services/rest2/soubory
Specifikace
Title	soubory

Operation

getSouborContent
Garance	Garantováno minimálně do 3.10.2025
Comment	Vrátí obsah zadaného souboru. Služba sama o sobě nevyžaduje přihlášení (ovšem soubor případně nevydá, pokud to u něj není povoleno)
HTTP metoda	GET
Adresa	/ws/services/rest2/soubory/getSouborContent
Možné výstupní MIME typy	*/*
Areas	root, downloads Area root Maximum number of concurrent calls 16 Maximum waiting time [ms] 2000 Area downloads Maximum number of concurrent calls 4 Maximum waiting time [ms] 5000
Authentication necessary	probably without the need to log in (however, based on the configuration of a specific IS/STAG installation, the service may require a login or a specific user role)

---

getSouborContentAuth
Garance	Garantováno minimálně do 3.10.2025
Comment	Vrátí obsah zadaného souboru. Služba vždy vyžaduje přihlášení
HTTP metoda	GET
Adresa	/ws/services/rest2/soubory/getSouborContentAuth
Možné výstupní MIME typy	*/*
Areas	root, downloads Area root Maximum number of concurrent calls 16 Maximum waiting time [ms] 2000 Area downloads Maximum number of concurrent calls 4 Maximum waiting time [ms] 5000
Authentication necessary	log in, authenticate with user role
Permitted roles	ALL

---

getSouborContentForThesesCZ
Garance	Garantováno minimálně do 3.10.2025
Comment	Vrátí obsah zadaného souboru. Určeno pouze pro komunikaci s Theses.CZ
HTTP metoda	GET
Adresa	/ws/services/rest2/soubory/getSouborContentForThesesCZ
Možné výstupní MIME typy	*/*
Areas	root, downloads Area root Maximum number of concurrent calls 16 Maximum waiting time [ms] 2000 Area downloads Maximum number of concurrent calls 4 Maximum waiting time [ms] 5000
Authentication necessary	log in, authenticate with special user account

---

getSouborMetadata
Garance	Garantováno minimálně do 3.10.2025
Comment	Vrátí metadata jednoho souboru zadaného identifikátorem.
HTTP metoda	GET
Adresa	/ws/services/rest2/soubory/getSouborMetadata
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 Area root Maximum number of concurrent calls 16 Maximum waiting time [ms] 2000
Authentication necessary	probably without the need to log in (however, based on the configuration of a specific IS/STAG installation, the service may require a login or a specific user role)

---

getSouborOpravneni
Garance	Garantováno minimálně do 3.10.2025
Comment	Vrátí informace o oprávněních aktuálního přihlášeného uživatele na zadaný soubor.
HTTP metoda	GET
Adresa	/ws/services/rest2/soubory/getSouborOpravneni
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 Area root Maximum number of concurrent calls 16 Maximum waiting time [ms] 2000
Authentication necessary	log in, authenticate with user role
Permitted roles	ALL

---

getSouboryMetadata
Garance	Garantováno minimálně do 3.10.2025
Comment	Vrátí metadata všech souborů dle zadaných kritérií (tj. například všechny soubory pro zadanou kvalifikační práci atd.). Není-li některý parametr uveden, znamená to, že na něm nezáleží. Zároveň vždy musí být uveden alespoň jeden parametr z množiny, která specifikuje objekt, na který je soubor navázán (tj. např. ID kvalifičkaní práce, ID žádosti atd...)
HTTP metoda	GET
Adresa	/ws/services/rest2/soubory/getSouboryMetadata
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 Area root Maximum number of concurrent calls 16 Maximum waiting time [ms] 2000
Authentication necessary	probably without the need to log in (however, based on the configuration of a specific IS/STAG installation, the service may require a login or a specific user role)

---

getTypSouboru
Garance	Garantováno minimálně do 3.10.2025
Comment	Vrátí požadovaný typ souboru.
HTTP metoda	GET
Adresa	/ws/services/rest2/soubory/getTypSouboru
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 Area root Maximum number of concurrent calls 16 Maximum waiting time [ms] 2000
Authentication necessary	probably without the need to log in (however, based on the configuration of a specific IS/STAG installation, the service may require a login or a specific user role)

---

getTypySouboru
Garance	Garantováno minimálně do 3.10.2025
Comment	Vrátí seznam všech typů souborů podporovaných v IS/STAG.
HTTP metoda	GET
Adresa	/ws/services/rest2/soubory/getTypySouboru
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 Area root Maximum number of concurrent calls 16 Maximum waiting time [ms] 2000
Authentication necessary	probably without the need to log in (however, based on the configuration of a specific IS/STAG installation, the service may require a login or a specific user role)

---

updateSouborSetExterniURL
Garance	Garantováno minimálně do 3.10.2025
Comment	Vymění soubor uložený v databázi IS/STAG (ODSTRANÍ JEJ) za zadané externí URL souboru. Pro role ADMINISTRATOR, KNIHOVNA a KNIHOVNA_SPRAVCE. Služba vrací řetězec OK pokud bylo v pořádku nastaveno, jinak vrací text chyby. Při volání této služby pro soubor nějaké kvalifikační práce se tato práce nepřeplánuje k odeslání do Theses.CZ.
HTTP metoda	GET
Adresa	/ws/services/rest2/soubory/updateSouborSetExterniURL
Možné výstupní MIME typy	text/plain
Areas	root Area root Maximum number of concurrent calls 16 Maximum waiting time [ms] 2000
Authentication necessary	log in, authenticate with user role
Permitted roles	AD (Administrator) KN (Library) KS (Library administrator)