breeze-chms
The breeze-chms
javascript library provides convenient access to the Breeze REST API from applications written in server-side JavaScript (Node).
Disclaimer: API wrappers are not necessarily created or maintained by Breeze.
Installation
Install the package with:
npm install breeze-chms --save
# or
yarn add breeze-chms
Usage
The package needs to be configured with your account's subdomain and secret API key. The subdomain is what comes before breezechms.com
in your browser address bar. Your unique/secret API key is available on the Extensions
page of your Breeze account https://YOURSUBDOMAIN.breezechms.com/extensions/api
. Require the package and initialize it with values for your subdomain and API key.
NOTE: DO NOT hardcode, expose, or otherwise commit your API key to a repository.
const breeze = require('breeze-chms')('SUBDOMAIN', 'APIKEY');
breeze.people
.get('PERSONID')
.then((person) => console.log(person.id))
.catch((error) => console.error(error));
Or using ES modules and async
/await
:
import Breeze from 'breeze-chms';
const breeze = new Breeze('SUBDOMAIN', 'APIKEY');
(async () => {
const person = await breeze.people.get('PERSONID');
console.log(person.id);
})();
This package uses Typescript and comes fully typed meaning it can provide code-hinting via Intellisense. If you're not familiar with Typescript—get started today!
Endpoints
Not all Breeze endpoints have been accounted for. See below for which ones are currently available. If you need something specific or have any comments, please open an issue—new endpoints will be implemented based on demand.
Dependencies
- Axios - Promise based HTTP client for the browser and node.js
Contributing
Feel free to open a pull-request with any changes if you'd like to help out! To develop locally, go through these few steps to get up and running:
> git clone https://github.com/Notebird-App/breeze-chms
> cd breeze-chms
> npm install
Next, you'll need to add a .env
file to the root directory that looks something like this (replacing the values with your own, of course):
subdomain=YOURSUBDOMAIN
key=YOURAPIKEY
This let's you properly run the tests via Jest. However, they might fail at first because they rely on a couple custom profile fields to be present in your account. So you can add Anniversary
, Date joined
, Service
, and Room Number
in your Breeze account as custom text fields. (You can remove these later if you wish)
Versioning
This project uses SemVer for versioning. For the versions available, see the tags on this repository.
Authors
License
This project is licensed under the MIT License - see the LICENSE.md file for details