Latest

Blog Detail Title

Short Content Here

by Author Name

Date Published

Developer

API Clean Up - What Changed in the Last Week?

Andrea Stubbe October 5, 2017

Being close to going live, we wanted to take the opportunity for some last minute cleanup. Because we want to go live with a version 1 that we're happy with, not just whatever we ended up with after eight months of developing.
Turned out, there was a lot we wanted to improve. Here's the list of updates from last week, and some tips on how to migrate over.

Big changes

We combined rate plans and extra services into a new module called 'rateplan'. Just change the paths:
catalog/services => rateplan/services
catalog/inventory => rateplan/inventory
rates/rateplans => rateplan/rateplan
rates/rates => rateplan/rates
Rate plans, inventory and services now all have a service type and a VAT type. The two values where previously concatenated, which was a bit dirty.

The booking model changed to accomodate new requirements:

  • In the output model, we do not include the reservations anymore. You can still get them, just call GET reservations and filter by bookingId.
  • The guest is now called 'primaryGuest', as a preparation to support more than one registered person in a room, instead of one registered person and a bunch of strangers.
  • We added a second comment field. Now there is one for the guest ("I am horribly allergic to peanuts and cats."), and one for the hotel team ("Forward the *peanut* allergy information to the restaurant team.")
  • We have less required fields in the addresses of booker and guest, to not annoy potential guests with filling out long forms. That also means you cannot rely on them being there. For the booker, only email and name are required, for the guest, only the name.
  • The guest and booker title now have actual values, not numbers. For now, there are Mr, Ms, Dr and 'other', if you are none of those, or don't want to tell.

Small changes

  • When amending a reservation, you now have to specify the number of persons.
  • Rate plans must have a cancellation policy set. You can define those using api.apaleo.com/settings/cancellation-policies.
  • renamed 'serviceIds' to 'extraServiceIds' in reservations, to make it clearer that those are not the services included in a predefined package.

Fix Spelling

The service type enum value 'accommodation' finally got its second 'm', and addressline1 and addressline2 were renamed to addressLine1 and addressLine2. Capital L.

Added

api.apaleo.com/finance/types/vat - gives you the VAT types and percentages for one specific country. We don't support many now, but that list will grow as we go.

Removed

The links are gone. We realized nobody was using them, and keeping them around seemed pretty useless.

That's all. We tried our best to come up with a clean structure and understandable names. If you have any feedback on what to improve or change (or also what you like), it would be amazing if you'd let us know - we build the API for you, and want you to like it.

Andrea Stubbe

Posted by

Andrea Stubbe
Andrea started coding as a kid, paused that for some years trying to find more interesting things, but then ended up doing that for a living. After working as a freelancer, researcher, teacher, and a normal employee in small and giant corporations, she fulfilled her childhood dream and co-founded a company a year ago. Being a fan of microservices since before she knew that term, she’s still contemplating how and if to use them in micro-sized companies.
Comments

RECENT ARTICLES

by Andrea Stubbe

05/02/2019

Push it! Webhooks in apaleo

The notification service allows you to build or set up apps which subscribe to certain events on apaleo (webhooks). When an event is triggered, we send an HTTP ...

by Benjamin Schmid

01/20/2019

Upsell Integration Guide

This guide explains how you can connect your upselling application, and offer extra services or room upgrades to guests. If you are new to apaleo APIs, head ...

by Andrea Stubbe

01/02/2019

UI Integration Guide

This guide explains how you can include your views into the apaleo user interface. This allows users to see information or even trigger actions in your ...

WANT MORE AMAZING THINGS?

Subscribe to our a-list for all the fun:

  • Keep up to date with hotel trends
  • Understand what matters most to hotel clients
  • Sweet gifs and special offers

Get it in your inbox every Monday ;)

By entering your email you expressly consent to receive our newsletter every week and other material related to...