This module implements (or will implemement) a the Smoobu API as at 23 January 2020. Currently it does not handle OAuth2 authentication.
The library is witten in Coffeescript V2 using native Promises and its only dependency is bent. You do not need Coffeescript to use the library; it is precompiled to Javascript ES6.
npm install smoobu
Get your API key from here.
const Smoobu = require('smoobu');
const API_KEY = "X.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
const smoobu = new Smoobu(API_KEY);
user = await smoobu.user();
console.log(`User ${user.id} is`, user.firstName, user.lastName);const smoobu = new Smoobu(API_KEY);If you wish to go through a proxy server, a proxy may
be passed in as a second argument. This is currently experimental
and will only work with the forked version of bent.
Each method in this library maps to a function in the Smoobu API. Please see the API documentation.
A number of methods have different return values from the underlying API call and these are documented below. In particular, dates are returned as javascript native dates rather than a string form. When a date is passed to a method, it may always be passed as a native javascript date or as a string in the form 'YYYY-MM-DD'.
All methods return Promises which resolve to a single result object
to the .then(). Optional parameters are shown within square
brackets: [ and ]. Methods may be called either as Promises or using
async/await syntax. No errors are dealt with inside the library
so all calls should have a .catch(err) to pick up the error. See
the Errors section of this document for more information.
smoobu.user();This is the Get User API call. The promise resolves to an object as below:
{
id: 7,
firstName: 'John',
lastName: 'Doe',
email: '[email protected]'
}This is the Availability API call. The method should be called with the arrival date, the departure date and optionally the apartment(s) to check. The apartments parameter can be passed as a number, an array of numbers or left out, in which case all apartments will be checked.
smoobu.availability(arrival, departure [, apartments])The promise resolves to the same structure as shown on the Smoobu API.
This has not yet been implemented.
This has not yet been implemented.
This will mark a booking as cancelled.
smoobu.cancelBooking(reservationID);This is the raw access to the Get Bookings API call. It takes an object as described on the Smoobu documentation and returns the raw data shown there. It does not handle paging internally.
See reservations() below for an easier interface.
smoobu.getBookings(params);This is a wrapper around getBookings() You pass it an apartment ID,
an optional start date, an optional end date and an optional boolean
for including cancellations (defaulting to true).
The method will collect all pages together and return a simple array
of all the bookings found. To pass a later parameter but default an
earlier one, simply pass null.
smoobu.reservations(apartmentID [, fromDate [, toDate [, showCancellation]]]);The array returned will be in the same form as the bookings key from
getBookings() but will be the data from all pages.
This implements the Get Booking API call. As single reservation ID is passed and and the full reservation details are returned.
smoobu.reservation(bookingID);This implements the Get Rates API call. It is passed a start date and an end date and, optionally, an apartment ID or an array of apartments IDs.
For each apartment, it returns a list of days within the range, showing the price, the minimum stay and the availability.
smoobu.getRates(startDate, endDate, apartments);This implements the Post Rates API call. This implementation relies on a Rate class which may found as Smoobu.Rate.
For each rate change to be made, you create a Rate object, passing
it the start date and the end date of the range to be changed. Using that
object, you set either the price property or the minstay property
or both. You then pass the rate object or an array of rate objects to
the setRates() method.
For example:
const Rate = Smoobu.Rate;
const rate = new Rate(new Date(), '2020-12-31');
rate.price = 123.45; // in the currency of the property
rate.minstay = 2; // in days
smoobu.setRates(rate, apartment);Note that both arguments to setRates() can be singletons or arrays.
Thus you can set the rates for multiple periods on multiple apartments,
if you wish.
The proxy server is no longer supported as bent does not seem to wish to support it.