Od czego zacząć prace z API?
Rozpoczynając korzystanie z usług RAD-on, możesz skorzystać z usługi prezentującej przekrojową wiedzę o usługach systemu RAD-on.
Usługa „Informacje o metadanych w systemie RAD-on” obejmuje między innymi:
1. Pobieranie listy dostępnych usług.
Zapytanie zwraca listę usług wraz z następującymi informacjami o każdej usłudze:
- nazwa encji
- aktualna wersję usługi
- opis w języku polskim
- opis w języku angielskim
- nazwa polska
2. Pobieranie swagger
Zapytanie zwraca plik json opisujący usługę – w zapytaniu należy wskazać nazwę encji, która nas interesuje.
Dokumentacja poszczególnych usług
Każda z udostępnionych usług posiada dokumentację opisującą parametry zapytania oraz strukturę odpowiedzi.
Przed skorzystaniem z usługi, należy zapoznać się z dokumentacją.
- Przykład dokumentacji dla danych zintegrowanych – Projekt
- Przykład dokumentacji dla danych z systemu POL-on – Kierunki studiów/uruchomienia
Rejestr zmian
Dodatkowo dla każdej usług udostępniony jest rejestr zmian, w którym publikowane są informacje o zmianach w poszczególnych wersjach usługi.
Rejestr można pobrać:
- z poziomu interfejsu użytkownika, na kafelku każdej usługi
- za pomocą metody udostępnionej w ramach usługi Informacje o metadanych w systemie RAD-on (w zapytaniu należy wskazać konkretną encję):