studentvue
v2.0.4
Published
An API based around the official StudentVUE's SOAP API. Automatically makes requests in the form of XML and automatically parses XML response into javascript objects.
Downloads
46
Maintainers
Readme
StudentVUE
StudentVUE is a tool for students to access classroom information from their institution or district. It uses a SOAP API, sending data in the form of XML. But, to access XML as usable data, it must be parsed which can be a tedious process. Thus, this library was created to let you use StudentVUE's API without needing to worry about parsing XML.
Disclaimer
Some methods will throw an error because some properties may be county-specific (See https://github.com/jwmarb/studentvue.js/pull/4). If you encounter a method that does not work, please open an issue or create a pull request fixing your issue. (See CONTRIBUTING)
Installation
npm
npm install studentvue
yarn
yarn add studentvue
Usage
To get started, we must first log in to start using the API.
import StudentVue from 'studentvue';
const DISTRICT_URL = 'https://...';
const USERNAME = '...';
const PASSWORD = '...';
const client = await StudentVue.login(DISTRICT_URL, { username: USERNAME, password: PASSWORD });
Once we are logged in, we can access any method within the API. Refer to Client documentation to see valid methods
Contributing
See CONTRIBUTING
License
Distributed under MIT © Joseph Marbella