uwaterloo-api
v1.0.2
Published
A wrapper around the uWaterloo Open Data API
Downloads
49
Maintainers
Readme
Installation
npm install uwaterloo-api
Usage
First, obtain a key from http://api.uwaterloo.ca to use the API
//Require the module
var uwaterlooApi = require('uwaterloo-api');
//Instantiate the client
var uwclient = new uwaterlooApi({
API_KEY : 'YOUR_KEY_HERE'
});
//Use the API
uwclient.get('/foodservices/menu', function(err, res) {
console.log(res);
});
uwclient.get('/events/holidays', function(err, res) {
console.log(res);
});
A list of all available endpoints can be found here.
Passing parameters
In order to pass query parameters, you can either put them directly in the path provided
uwclient.get('/courses/CS/247/schedule', {}, function(err, res){
console.log(res);
});
Or, if you prefer, add them as dynamic parameters
uwclient.get('/courses/{course_sbuject}/{course_number}/schedule', {
course_subject : 'CS',
course_number : 247
}, function(err, res) {
console.log(res);
});
Any additional parameters provided are automatically added to the QueryString
.
Testing
Running the tests requires an API_KEY as mentioned above. Once a key is obtained, set the following variable :
# In ~/.bash_profile
export uwApiToken=SOME_TOKEN
and run
npm install
npm test
Contributing
- Fork the repo
- Create a feature branch
- Add test cases if necessary
- Push your changes and create a PR
License
MIT