Veracross SDK

A Java SDK library for Veracross Student API

IntroductionDevelopmentLicense

Introduction:

Features:

• Log in to Veracross with single-sign-on.
• Get the list of courses the student is taking.
• Get a list of all the assignments in a course.
• Get the list of messages, or notifications.
• Get the list of calendar events in between dates.
• Supports both legacy apis on portals.veracross.com and new apis on portals-app.veracross.com.

Note: Currently, this SDK library only works for St. John's with single-sign-on, because logging in directly to Veracross would require an authenticity token from Recaptcha. If you want to use this library and you are from another school, you need to find out how your school handles single-sign-on and implement it yourself. (Look into StJohnsHttpClient.java for details)

Maven Import:

Add the JitPack repo into your pom.xml first:

<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>

Then you can add this library as dependency:

<dependency>
<groupId>com.github.hydevelop</groupId>
<artifactId>VeracrossAnalyzer.SDK</artifactId>
<version>3.2.0.327</version>
</dependency>

Make sure you reimport if you're using IntelliJ IDEA!

Development:

Setting Up:

Look at the Maven section, if you have successfully imported the maven dependency, you should be able to access the classes. If you don't know what maven is, click here.

Usage Tutorial:

1. Login from St. John's:

// Create a new http client objectStJohnsHttpClientstJohns = newStJohnsHttpClient();
// Login with username and passwordstJohns.login("username", "password");

2. Use single-sign-on to login to Veracross:

// Login and store it in a variableVeracrossHttpClientveracross = stJohns.veracrossLoginSSO();

3. Get the list of courses the student is taking:

VeraCoursescourses = veracross.getCourses();

4. Get a list of all the assignments in a course:

// Get the assignments id from a course.longassignmentsId = courses.get(0).getAssignmentsId();
// Pass in the assignments id to get the list of assignments.// Note: the assignments id is different from the course id!VeraAssignmentsassignments = veracross.getAssignments(assignmentsId);

5. Get the list of messages, or notifications:

// Get messages starting at index 0 (Which is all the messages).List<VeraMessage> messages = veracross.getMessages(0);

6. Get the list of calendar events in between dates:

// Get calendar events from 5 days ago to 5 days later.List<VeraCalendarEvent> events = veracross.getEvents(-5, 5);
// Get calendar events in between two dates.List<VeraCalendarEvent> events2 = veracross.getEvents(newDate(), newDate());

7. Save cookies for later:

// Get cookiesList<Cookie> cookies = veracross.getCookies().getCookies();
// Do whatever you want to save them.// In this case, I'll just use Gson to save them as JSON.StringcookiesJson = newGson().toJson(cookies);

8. Restore cookies:

// Get the original list of cookies backList<Cookie> restoredCookies = newGson().fromJson(cookiesJson, newTypeToken<List<BasicClientCookie>>(){}.getType());
// Restore them to a new Veracross clientVeracrossHttpClientrestoredVeracross = newVeracrossHttpClient();
restoredVeracross.restoreCookies(restoredCookies);

If you need help:

1. Ask Google
2. Post an issue here.

License: MIT

The MIT license basically means that this project is open-soucred and you can do whatever you want with it, as long as you include a copy of this license in your distribution. You don't have to ask for permissions to use or anything. However, if you do bad things with it, I'm not responsible.