@exlibris-sdks/alma v0.1.0

Alma NodeJS

A nodeJS wrapper for the Alma API

Usage

npm install git+ssh://git@github.com/ExLibris-SDKs/Alma-NodeJS.git#master

const AlmaClient = require('alma-api-wrapper')

const almaApi = new AlmaClient({
    region: 'eu', // defaults to eu
    apikey: 'my_alma_api_key' // the api key can also be set on the environment variable ALMA_KEY
})

almaApi.users.for('my_user').loans()
    .then(loans => console.log(loans[0].data))

The wrapper covers retrieving certain data for Users in Alma. All user endpoints are covered in the User class, which exists on almaApi.users. almaApi.users.get(userID) Calls GET /users/<userID>, returns a promise which resolves with a new User instance created from the API data.

almaApi.users.for(userID) Returns a new instance of the User class.

user.loans() Calls GET /users/<userID>/loans, returns a promise which resolves with an array of Loan instances.

user.getLoan(loanID) Calls GET /users/<userID>/loans/<loanID>, returns a promise which a Loan instance created from the API data.

user.requests() Calls GET /users/<userID>/requests, returns a promise which resolves with an array of Request instances.

user.getRequest(requestID) Calls GET /users/<userID>/requests/<requestID>, returns a promise which a Request instance created from the API data.

user.fees() Calls GET /users/<userID>/fees, returns a promise which resolves with an array of Fee instances.

user.getFee(feeID) Calls GET /users/<userID>/fees/<feeID>, returns a promise which a Fee instance created from the API data.

All class instances created by API calls will have the raw API data stored on data property of the class

Development

It is intended that this package can be extended to cover more, or all, of the current Alma API. Contributions to this service or any of the associated services and packages are welcome.