USOS API Installations

Key facts:

  • There are multiple USOS API installations. Each university/institution has their own installation.
  • Each installation issues its own Consumer Keys.
  • There is one additional USOS API installation, unbound to any institution. It is called the mother server and it is reserved for internal use (see below for details).

Single-target or Multi-target Architecture

First you have to choose whether:

  • You want your application to interact with data of one, single institution, or
  • You want your application to interact with many institutions at the same time.

This is an important design decision as it might influence the entire structure of your application.

Regardless of what you choose, we advise you to NOT "hardcode" absolute API method URLs in your application. Use an usosapi_base_url variable as a prefix and simply append service names to that variable (and replace "http://" with "https://" in case of some methods). This way, your application might be easily copied and run on other USOS API installations in future.

Notes on Multi-target Architecture

USOS API installations might differ slightly. This is due to the USOS system distrubution requirements (each institution might have different versions of the USOS system).

If you plan to connect to multiple installations, it might be better to use the oldest (lowest version number) USOS API installation as the documentation reference. It will let you avoid some misassumptions.

You can use the services/apisrv/installations method to retrieve the current list all installations. You might, for example, periodically check it against the list of installations your application supports, and notify yourself if there is a new one (then, you can generate a new API key and include it in your application).

And remember, that all the data (even when available anonymously) is copyrighted.

What's a mother server?

The mother server is a "special" USOS API installation.

  • There's only one USOS API mother server: http://apps.usos.edu.pl/.
  • It is visible to all the search engines, but it is not intended to be used for calling methods.
  • You cannot register a Consumer Key in the mother server.
  • You should not call any API methods on the mother server without consulting USOS API developers. Even if the method can be called anonymously.
  • The mother server may contain more recent documentation than any of the other servers. You may use it to take a "sneak peek" at new features.

Why mother server exists?

  • The mother server is used as a central synchronization server between all the other USOS API installations. I.e. it provides other USOS API servers with the data needed to "discover" each other.
  • In the future, we may also use the mother server's domain to serve some extra content related to USOS API in general (and unrelated to the specific USOS API installation). For example, the USOS API blog.

Current installations

USOS API is currently running on the following USOS installations:

  1. Akademia Wychowania Fizycznego im. Bronisława Czecha w Krakowie

    Address: https://usosapi.awf.krakow.pl/
    Version: 6.7.1.0-0, 89fa21c2, dirty (2021-09-20)
    Documentation: https://usosapi.awf.krakow.pl/developers/api/
    Administrators: usos@awf.krakow.pl, michal.pysz@uj.edu.pl, jaroslaw.gorski@awf.krakow.pl

  2. Chrześcijańska Akademia Teologiczna

    Address: https://usosapps.chat.edu.pl/
    Version: 6.7.0.1-3, 51fd8be2 (2021-07-19)
    Documentation: https://usosapps.chat.edu.pl/developers/api/
    Administrators: dsksysadm@adm.uw.edu.pl

  3. Jan Dlugosz University in Czestochowa

    Address: https://usosapps.ujd.edu.pl/
    Version: 6.7.0.2-4, c8a83062, dirty (2021-08-06)
    Documentation: https://usosapps.ujd.edu.pl/developers/api/
    Administrators: m.wrona@ujd.edu.pl

  4. Lomza State University of Applied Sciences

    Address: https://api.pwsip.edu.pl/usosapps/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://api.pwsip.edu.pl/usosapps/developers/api/
    Administrators: mdabrowski@pwsip.edu.pl

  5. National Academy of Dramatic Art in Warsaw

    Address: https://usosapps.at.edu.pl/
    Version: 6.7.0.1-3, 51fd8be2 (2021-07-19)
    Documentation: https://usosapps.at.edu.pl/developers/api/
    Administrators: dsksysadm@adm.uw.edu.pl, noreply@at.edu.pl

  6. PEUH

    Address: https://usosapps.euh-e.edu.pl/
    Version: 6.6.1.0-6, 538c91a1 (2021-06-07)
    Documentation: https://usosapps.euh-e.edu.pl/developers/api/
    Administrators: leszek@euh-e.edu.pl, r.malentowicz@euh-e.edu.pl.pl

  7. PWSTE w Jarosławiu

    Address: https://apps.pwste.edu.pl/
    Version: 6.7.0.1-3, 51fd8be2, dirty (2021-07-19)
    Documentation: https://apps.pwste.edu.pl/developers/api/
    Administrators: andrzej.ciechanowski@pwste.edu.pl

  8. SGH Warsaw School of Economics

    Address: https://usosapps.sgh.waw.pl/
    Version: 6.7.1.0-0, e584716d (2021-09-30)
    Documentation: https://usosapps.sgh.waw.pl/developers/api/
    Administrators: usosadmin@sgh.waw.pl

  9. The Academy of Fine Arts and Design in Katowice

    Address: https://apps.asp.katowice.pl/
    Version: 6.7.0.1-3, 51fd8be2, dirty (2021-07-19)
    Documentation: https://apps.asp.katowice.pl/developers/api/
    Administrators: admin@asp.katowice.pl

  10. The Adam Mickiewicz University in Poznan

    Address: https://usosapps.amu.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapps.amu.edu.pl/developers/api/
    Administrators: usosweb@amu.edu.pl

  11. The Bialystok School of Economics

    Address: https://usosapps.wse.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapps.wse.edu.pl/developers/api/
    Administrators: usosweb@wse.edu.pl

  12. The Bydgoszcz University of Science and Technology

    Address: https://usosapps.pbs.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapps.pbs.edu.pl/developers/api/
    Administrators: usosapps@pbs.edu.pl

  13. The Cardinal Stefan Wyszynski University

    Address: https://apps.usos.uksw.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://apps.usos.uksw.edu.pl/developers/api/
    Administrators: auto.aos@csi.uksw.edu.pl

  14. The Carpathian State University in Krosno

    Address: https://usosapps.pwsz.krosno.pl/
    Version: 6.5.2.0-13, 1130466e (2020-07-16)
    Documentation: https://usosapps.pwsz.krosno.pl/developers/api/
    Administrators: mateusz.lorenc@kpu.krosno.pl

  15. The Cracow University of Economic

    Address: https://appsusos.uek.krakow.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://appsusos.uek.krakow.pl/developers/api/
    Administrators: kepperta@uek.krakow.pl, jobg@uek.krakow.pl, stasiekd@uek.krakow.pl

  16. The Feliks Nowowiejski Academy of Music

    Address: https://www.usosapi.amuz.bydgoszcz.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://www.usosapi.amuz.bydgoszcz.pl/developers/api/
    Administrators: usospgmm@gmail.com

  17. The Helena Chodkowska University of Law in Wrocław

    Address: https://apps.prawowroclaw.edu.pl/
    Version: 6.6.0.0-11, 38c91d62 (2020-10-20)
    Documentation: https://apps.prawowroclaw.edu.pl/developers/api/
    Administrators: usos@prawowroclaw.edu.pl, roman.haligowski@prawowroclaw.edu.pl

  18. The Jagiellonian University

    Address: https://apps.usos.uj.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2, dirty (2021-09-20)
    Documentation: https://apps.usos.uj.edu.pl/developers/api/
    Administrators: michal.pysz@uj.edu.pl, usosweb@uj.edu.pl

  19. The Jerzy Kukuczka Academy of Physical Education in Katowice

    Address: https://usosapps.awf.katowice.pl/
    Version: 6.6.1.0-6, 538c91a1, dirty (2021-06-07)
    Documentation: https://usosapps.awf.katowice.pl/developers/api/
    Administrators: s.kwiatkowski@awf.katowice.pl, s.liszowski@awf.katowice.pl

  20. The Kazimierz Wielki University

    Address: https://api.ukw.edu.pl/
    Version: 6.7.2.0-0, c157340c (2021-11-19)
    Documentation: https://api.ukw.edu.pl/developers/api/
    Administrators: marekmac@ukw.edu.pl

  21. The Kielce University of Technology

    Address: https://api.usos.tu.kielce.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://api.usos.tu.kielce.pl/developers/api/
    Administrators: d.walczyk@tu.kielce.pl

  22. The Military University of Technology in Warsaw

    Address: https://usosapps.wat.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapps.wat.edu.pl/developers/api/
    Administrators: karol.rudyk@wat.edu.pl

  23. The Nicolaus Copernicus University

    Address: https://usosapps.umk.pl/
    Version: 6.7.1.0-0, 89fa21c, dirty (2021-09-20)
    Documentation: https://usosapps.umk.pl/developers/api/
    Administrators: grusia@umk.pl, marekcz@umk.pl, efa@umk.pl

  24. The Opole University of Technology

    Address: https://usosapps.po.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2, dirty (2021-09-20)
    Documentation: https://usosapps.po.edu.pl/developers/api/
    Administrators: r.walkow@po.opole.pl

  25. The Pontifical University of John Paul II

    Address: https://usosapi.upjp2.edu.pl/
    Version: 6.7.0.2-4, c8a83062 (2021-08-06)
    Documentation: https://usosapi.upjp2.edu.pl/developers/api/
    Administrators: mpikula@opteam.pl

  26. The Poznań University of Economics and Business

    Address: https://usosapps.ue.poznan.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapps.ue.poznan.pl/developers/api/
    Administrators: michal.kubiak@ue.poznan.pl

  27. The Rzeszów University of Technology

    Address: https://usosapps.prz.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2, dirty (2021-09-20)
    Documentation: https://usosapps.prz.edu.pl/developers/api/
    Administrators: piotrb@prz.edu.pl

  28. The Siedlce University of Natural Sciences and Humanities

    Address: https://apps.uph.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2, dirty (2021-09-20)
    Documentation: https://apps.uph.edu.pl/developers/api/
    Administrators:

  29. The Silesian University of Technology

    Address: https://usosapi.polsl.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapi.polsl.pl/developers/api/
    Administrators: mpikula@opteam.pl

  30. The Stanisław Staszic University of Applied Sciences in Piła

    Address: https://usosapi.puss.pila.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapi.puss.pila.pl/developers/api/
    Administrators: mpikula@opteam.pl, dleszczynski@puss.pila.pl

  31. The State College of Applied Sciences in Skierniewice

    Address: https://apps.pusb.pl/
    Version: 6.6.1.0-6, 538c91a1 (2021-06-07)
    Documentation: https://apps.pusb.pl/developers/api/
    Administrators: sosadowski@pusb.pl, lrybak@pusb.pl, pgajewski@pusb.pl

  32. The Technical University of Koszalin

    Address: https://usosapi.tu.koszalin.pl/
    Version: 6.6.1.0-6, 538c91a1, dirty (2021-06-07)
    Documentation: https://usosapi.tu.koszalin.pl/developers/api/
    Administrators: usos-admin@tu.koszalin.pl

  33. The University University of Technology and Economics

    Address: https://usosapps.uth.edu.pl/
    Version: 6.7.0.2-4, c8a83062, dirty (2021-08-06)
    Documentation: https://usosapps.uth.edu.pl/developers/api/
    Administrators: it@uth.edu.pl, wdrozenia@usos.edu.pl

  34. The University of APS

    Address: https://apps.aps.edu.pl/
    Version: 6.7.0.1-3, 51fd8be2 (2021-07-19)
    Documentation: https://apps.aps.edu.pl/developers/api/
    Administrators: ypagani@aps.edu.pl, pg@aps.edu.pl

  35. The University of Agriculture

    Address: https://usosapi.ur.krakow.pl/
    Version: 6.7.1.0-0, 89fa21c2, dirty (2021-09-20)
    Documentation: https://usosapi.ur.krakow.pl/developers/api/
    Administrators: p.straszak@ur.krakow.pl

  36. The University of Bialystok

    Address: https://usosapps.uwb.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapps.uwb.edu.pl/developers/api/
    Administrators: usosweb@uwb.edu.pl

  37. The University of Euroregional Economy in Józefów - Warsaw

    Address: https://usosapi.wsge.edu.pl/
    Version: 6.7.0.1-3, 51fd8be2 (2021-07-19)
    Documentation: https://usosapi.wsge.edu.pl/developers/api/
    Administrators: MDrozd@opteam.pl

  38. The University of Lodz

    Address: https://usosapps.uni.lodz.pl/
    Version: 6.7.1.0-0, 89fa21c2b (2021-09-20)
    Documentation: https://usosapps.uni.lodz.pl/developers/api/
    Administrators: pcieslak@uni.lodz.pl

  39. The University of Lower Silesia

    Address: https://usosapps.dsw.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapps.dsw.edu.pl/developers/api/
    Administrators: lukasz.bojda@dsw.edu.pl

  40. The University of Maria Curie-Skłodowska

    Address: https://apps.umcs.pl/
    Version: 6.7.2.0-0, c157340c, dirty (2021-11-19)
    Documentation: https://apps.umcs.pl/developers/api/
    Administrators: usos@umcs.pl

  41. The University of Opole

    Address: https://usosapps.uni.opole.pl/
    Version: 6.7.1.0-0, 89fa21c (2021-09-20)
    Documentation: https://usosapps.uni.opole.pl/developers/api/
    Administrators: paszczus@uni.opole.pl

  42. The University of Silesia in Katowice

    Address: https://usosapps.us.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapps.us.edu.pl/developers/api/
    Administrators: mateusz.falfus@us.edu.pl, lukasz.wachstiel@us.edu.pl

  43. The University of Warmia and Mazury in Olsztyn

    Address: https://apps.uwm.edu.pl/
    Version: 6.6.1.0-3, 39b44b83 (2021-04-06)
    Documentation: https://apps.uwm.edu.pl/developers/api/
    Administrators: b.nitkiewicz@uwm.edu.pl

  44. The University of Warsaw

    Address: https://usosapps.uw.edu.pl/
    Version: 6.7.1.0-0, 89fa21c2 (2021-09-20)
    Documentation: https://usosapps.uw.edu.pl/developers/api/
    Administrators: dsksysadm@adm.uw.edu.pl

  45. The University of Wroclaw

    Address: https://usosapps.uni.wroc.pl/
    Version: 6.7.0.1-3, 51fd8be2, dirty (2021-07-19)
    Documentation: https://usosapps.uni.wroc.pl/developers/api/
    Administrators: pawel.soltysiak@uwr.edu.pl, tomasz.mielnik@uwr.edu.pl, marek.kasinski@uwr.edu.pl

  46. The Warsaw University of Technology

    Address: https://apps.usos.pw.edu.pl/
    Version: 6.7.0.1-3, 51fd8be2, dirty (2021-07-19)
    Documentation: https://apps.usos.pw.edu.pl/developers/api/
    Administrators: Marek.Majchrowski@pw.edu.pl, Piotr.Wojcik@pw.edu.pl, Mariusz.Stelmach@pw.edu.pl, Maciej.Podstawka@pw.edu.pl, Marcin.Drozd@pw.edu.pl, Konrad.Kleczkowski@pw.edu.pl

  47. The Wroclaw University of Economics

    Address: https://usosapps.ue.wroc.pl/
    Version: 6.7.1.0-0, 89fa21c2, dirty (2021-09-20)
    Documentation: https://usosapps.ue.wroc.pl/developers/api/
    Administrators: lukasz.bojda@ue.wroc.pl

  48. The Wrocław University of Environmental and Life Science

    Address: https://usosapps.upwr.edu.pl/
    Version: 6.6.0.0-14, cdb6615f, dirty (2020-12-22)
    Documentation: https://usosapps.upwr.edu.pl/developers/api/
    Administrators: usos@upwr.edu.pl

  49. The president Stanisław Wojciechowski Higher Vocational State School in Kalisz

    Address: https://apps.pwsz.kalisz.pl/
    Version: 6.6.0.0-12, 1aa418e7 (2020-11-25)
    Documentation: https://apps.pwsz.kalisz.pl/developers/api/
    Administrators: wdrozenia@usos.edu.pl

  50. Uniwerstytet Muzyczny Fryderyka Chopina

    Address: https://usosapps.chopin.edu.pl/
    Version: 6.6.1.0-6, 538c91a1, dirty (2021-06-07)
    Documentation: https://usosapps.chopin.edu.pl/developers/api/
    Administrators: dsksysadm@adm.uw.edu.pl

  51. VISTULA UNIVERSITY

    Address: https://usosapps.vistula.edu.pl/
    Version: 6.7.0.1-3, 51fd8be2 (2021-07-19)
    Documentation: https://usosapps.vistula.edu.pl/developers/api/
    Administrators:

  52. Wyższa Szkoła Bezpieczeństwa Publicznego i Indywidualnego „Apeiron” w Krakowie

    Address: https://usosapi.apeiron.edu.pl/
    Version: 6.5.0.0-7, 40800f97, dirty (2019-10-04)
    Documentation: https://usosapi.apeiron.edu.pl/developers/api/
    Administrators: wdrozenia@usos.edu.pl, mopalinska@opteam.pl

USOS API ver. 6.1.2.0-3, 7f29f74c, dirty (2020-10-21)