Moje zajęcia - ISOD WAPI Documentation

Moje przedmioty `mycourses`

Zapytanie zwraca w formacie JSON szczegółowe informacje o postępach nauki, ogłoszeniach, końcowym zaliczeniu studenta w ramach konkretnego terminu zajęć.

URL

/isod-portal/wapi?q=myclass&username=?&apikey=?id=?

https://isod.ee.pw.edu.pl/isod-portal/wapi?q=myclass&...

Metody

GET

URL Params

Wymagane:

q=myclass - rodzaj zapytania kierowanego do WAPI - musi być równe myclass,

username=[napis] - nazwa użytkownika ISOD (login),

apikey=[napis] - klucz identyfikacyjny API, który można wygenerować na stronie z danymi osobowymi w ISOD.

id=[napis] - identyfikator terminu zajęć, na które zapisany jest student. Identyfikator zwracany jest jako atrybut terminu zajęć w kolekcji przedmiotów studenta mycourses.

Odpowiedź pozytywna

Kod: 200
Zawartość (JSON)

{
   "header":{
      "courseNumber":"1DR1117",
      "courseName":"Podstawy programowania",
      "type":"L",
      "hours":30,
      "day":"Wtorek",
      "timeFrom":"04:15:00 PM",
      "timeTo":"06:00:00 PM",
      "cycle":"co tydzień",
      "groups":"GR1, ",
      "place":"Stara Kotłownia 204",
      "academicSemester":"2014Z",
      "teachers":"mgr inż. Tomxxx Mixxxx, dr inż. Doxxx Olxxxxx",
      "id":"W8t5rAuCfffcyVDbbh5OHI2w"
   },
   "announcements":[
      {
         "title":"Temat ogłoszenia dotyczącego pierwszego laboratorium",
         "content":"Zasady zaliczenia:\n\nLorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n\n\n1. Atqui haec patefactio quasi rerum opertarum, cum quid quidque sit aperitur, definitio est.\n2. Illa sunt similia: hebes acies est cuipiam oculorum, corpore alius senescit;\n3. Nam diligi et carum esse iucundum est propterea, quia tutiorem vitam et voluptatem pleniorem efficit.\n4. Nam, ut paulo ante docui, augendae voluptatis finis est doloris omnis amotio.\n5. Conferam tecum, quam cuique verso rem subicias;\n\nYour Best Teacher",
         "author":"mgr inż. Toxxxxx Mixxxx",
         "dateModified":"30.08.2018 16:56",
         "dateExpired":"31.08.2018 00:00"
      }
   ],
   "columns":[
      {
         "type":"Tekst",
         "weight":1.0,
         "accounted":false,
         "personModifying":" "
      },
      {
         "date":"16.12.2014 16:07",
         "dateModified":"16.12.2014 16:07",
         "name":"mgr inż.",
         "type":"Tekst",
         "value":"+++++++++++",
         "weight":1.0,
         "accounted":false,
         "personModifying":"Toxxxxx Mixxxx",
         "personModifyingTitle":"mgr inż."
      },
      {
         "date":"16.12.2014 16:07",
         "dateModified":"25.11.2014 17:28",
         "name":"Porzadnie",
         "type":"Kolokwium",
         "value":"23",
         "weight":1.0,
         "accounted":true,
         "personModifying":"Toxxxxx Mixxxxx",
         "personModifyingTitle":"mgr inż."
      }
   ],
   "id":"W8t5rAussCcDVDkh5OHI2w",
   "summary":"Przykładowe podsumowanie",
   "summaryNotes":"Bardzo ładnie napisane sprawozdanie końcowe. Główna ocena wynika właśnie z niego.",
   "credit":"4.5",
   "creditModifiedBy":"mgr inż. Toxxxxx Mixxxx",
   "creditModifiedDate":"30.08.2018 16:53",
   "summaryModifiedBy":"mgr inż. Toxxxxx Mixxxx",
   "username":"bakxxxxx",
   "semester":"2014Z",
   "firstname":"Kaxxxx",
   "lastname":"Baxxxxx",
   "studentNo":"270xxx"
}

header - klucz zawierający podstawowe metadane dotyczące przedmiotu oraz terminu zajęć.
announcements - kolekcja ogłoszeń związanych z przedmiotem (zwracacana cała kolekcja, nawet z przeterminowanymi ogłoszeniami, aplikacja zewnętrzna powinna ukrywać ogłoszenia po terminie).
columns - kolekcja pól dotyczących kolejnych kolumn 'dziennika prowadzącego'. To są wyniki, obecności z poszcególnych
ćwiczeń laboratoryjnych, komputerowych, egzaminów, itp...
summary - pole tekstowe, w którym prowadzący wpisuje podsuwanie zajęć: punkty, ocenę końcową, słowne zaliczenie, itp.
summaryNotes - komentarz do podsumowania,
credit - ocena zaliczeniowa (na podstawie tej oceny określane jest przy wyznaczaniu opłaty za przedmiot czy dana składowa kursu została zaliczona)

Komunikat błędu

Kod: 400

Błędy zwracane są za pomocą komunikatu tekstowego zamkniętego w obiekt JSON, z atrybutem message np.:

{"message":"Brak wymaganego argumentu dotyczącego semestru akademickiego. Oczekiwałem na przykład: ?sem=2010Z"}

Przykładowe zapytanie

https://isod.ee.pw.edu.pl/isod-portal/wapi?q=myclass&username=bakxxxxx&apikey=CHANGE_ME&id=CHANGE_ME_TOO

Uwagi

Brak.

Moje przedmioty mycourses

URL