KOSapi poskytuje aplikační rozhraní v podobě RESTful webových služeb, které zprostředkovává přístup k vybrané části dat z KOSu. Umožňuje a podporuje vznik školních i studentských aplikací, které pro svou činnost vyžadují online aplikační přístup k datům souvisejícím s výukou. Odstraňuje nutnost zpracovávání exportů, neustálou duplikaci všech dat a potíže s jejich udržováním. Staví na osvědčených konceptech webu jakožto distribuovaného prostředí vzájemně provázaných informací.
Zdrojem dat pro KOSapi jsou momentálně databázové exporty. V případě aktuální verze KOSapi-3 se jedná o dočasné řešení, neboť ta už je připravená pro přímé napojení na databázi KOS. Máme připravené příslušné databázové pohledy a momentálně dovršují jednání s VIC o poskytnutí přístupu. Poté bude KOSapi-3 poskytovat read-only přístup ke všem datům týkající se Bílé knihy a rozvrhů, která jsou dostupná celé akademické obci fakulty. Získání práva zápisu do KOSu je při současném přístupu VIC bohužel nereálné, nicméně do budoucna to plánujeme.
Aktuálně jsou dostupné instance pro FEL a FIT, prakticky není problém spustit instance i pro další fakulty ČVUT. Provoz KOSapi technicky zajišťuje SVTI FEL, resp. IT oddělení FIT.
Na tomto webu najdete dokumentaci KOSapi-3, bug tracking a přehled novinek. Dokumentace je pro obě fakulty společná, jednotlivé instance FEL a FIT se liší pouze doménou v URL a daty, která poskytují. Chcete-li zadat požadavek nebo reportovat chybu, přihlaste se prosím svým loginem do KOSu* - ověřování probíhá proti LDAP serveru Usermap. Autorizace pro tento web a KOSapi jsou zcela nezávislé. Informace k autentizaci do webových služeb KOSapi najdete na stránce o zabezpečení.
*Heslo se přenáší přes šifrovaný kanál, nikdo k němu nemá přístup ani se neloguje. Pokud k tomu přesto nemáte důvěru, napište mi prosím na kosapi@feld.cvut.cz o založení lokálního účtu.
Dokumentaci předchozích verzí 1 a 2 naleznete na staré wiki. Tyto verze jsou na obou fakultách stále v provozu a podporované, ale už se nebudou dále vyvíjet. Aktuální verze je ale ještě plně nenahrazuje, neboť zatím postrádá zdroje týkající se rozvrhů a studentů. Pakliže tato data potřebujete, použijte KOSapi-2, příp. KOSapi-1.
Na konci června proběhlo jednání se zástupcem VIC o zpřístupnění DB pohledů v KOSu, které dopadlo úspěšně, tedy alespoň jsme si to všichni mysleli. Jenže dotyčný člověk tento souhlas dodatečně zatížil podmínkami, na které jsme nemohli přistoupit. Zvolili jsme tedy jinou cestu, a to podání žádosti přes děkany FEL a FIT na rektorát. Žádost děkani podali ke konci srpna a od té doby se táhnou jednání na úrovni rektorátu, která ještě pořád nebyla završena.
KOSapi-3 je aktuálně ve stádiu alfa testování. Vzhledem k tomu, že ještě nemáme povolený přístup do KOSu, se kterým KOSapi-3 již počítá, tak je rozsah zdrojů a dat omezen pouze na podmnožinu, kterou lze získat z exportu Bílé knihy. Jakmile dojde k napojení na KOS, přibudou zbývající zdroje týkající se rozvrhů, zkoušek, informací o studentech atd.