liumcse / ntuvibe

NTUVibe is a student-run online platform committed to making information at Nanyang Technological University more open and accessible.
https://ntuvibe.com
8 stars 0 forks source link

Link to NTULearn and NTU Maps in Scheduler #110

Open zhangks98 opened 5 years ago

zhangks98 commented 5 years ago

Is your feature request related to a problem? Please describe. When checking the schedule, one may be interested in the corresponding course page on NTULearn and the exactly where the venue is. The course page can be linked via https://ntulearn.ntu.edu.sg/webapps/blackboard/execute/launcher?type=Course&id={course_id} Query venues on NTU Map http://maps.ntu.edu.sg/maps#q:{venue}

Describe the solution you'd like

  1. Map from the existing NTU course code to NTULearn (a.k.a Blackboard Learn, or BBLearn for short) compatible. Luckily BBLearn exposes its courses API to achieve this:

Sample response from the API (need to login to NTULearn): https://ntulearn.ntu.edu.sg/learn/api/public/v1/courses?sort=created(desc)

The response potentially contains course data dating back to 2010. To view more response, refer to the "nextPage" attribute from the JSON

We can then persist id data from the API, group by course_id (e.g. CE3005) and term (e.g. 19S1), searchable by activity (e.g. LEC, TUT, LAB). Which gives us the possibility to link to the page.

  1. Create clickable link on Course Schedule Cards, link to NTULearn and NTU Map.

Additional context

  1. The course activity name on BBLearn may not be consistent with ones found on NTU Schedule.
  2. All available Blackboard Learn APIs https://developer.blackboard.com/portal/displayApi
liumcse commented 5 years ago

@chenchongsong See this