npm install bth-api

const api = require('bth-api');

// Fetch course books, fetches the available course plans,
//  picks the latest one, downloads the PDF and exctracts
//  ISBN numbers, which it returns
const books = await api.fetchCourseBooks('MA1444');

console.print(books[0]);

> ISBN 978-91-47-05291-2

Note: For now, the API uses requires an auth parameter to authenticate. The key is received by signing in to the student portal at BTH's website and extracting the value for the cookie '.BTHAT'.

  const api = require('bth-api');
  api.fetchUserInfo(auth);
  api.fetchScannedExams(auth);
  api.fetchScannedExams(examId, auth);
  api.fetchScannedExam(examId, auth);
  api.fetchExamRegistrations(auth);
  api.fetchCourseRegistrations(auth);
  api.fetchCoursePlans(courseId);
  api.fetchCoursePlan(courseId, revision, asText = false);
  api.fetchCourseBooks(courseId);
  api.fetchComingExams(from, to, courseId);
  api.fetchActiveCourses(auth);
  api.fetchAccessCards(auth);
  api.fetchCourseResults(auth, courseId, courseOccasion, courseCode);

Note: the documentation is not yet completed. The API is still subject to change.

Any contribution is welcome. If you're not able to code it yourself, perhaps someone else is - so post an issue if there's anything on your mind.

Clone the repository:

git clone https://github.com/AlexGustafsson/bth-api.git && cd bth-api

Set up for development:

npm install

Follow the conventions enforced:

npm test

Although the project is very capable, it is not built with production in mind. Therefore there might be complications when trying to use the API for large-scale projects meant for the public. The API was created to easily fetch student related information from BTH's services programmatically and as such it might not promote best practices nor be performant. This project is not in any way affiliated with Blekinge Tekniska Högskola (BTH).