Latest

Blog Detail Title

Short Content Here

by Author Name

Date Published

Developer

Getting Started with apaleo APIs

Andrea Stubbe October 15, 2017

Have a look

You can find all of apaleo's API on api.apaleo.com. We use Swagger to describe it, and to generate our documentation.

Sign up

The first step is to sign up for your free trial account. After you finish signup you will be able to login to apaleo and start configuring your properties. Also you can use the same credentials to access our API using Swagger.

Get access for your app

Request your very own client credentials that lets you play with the API in your test account.

Use it

apaleo APIs are protected using OAuth2 - the de-facto standard for API security. Here's a short guide to get you started:

Step 1: To get access to our APIs, you need to use your client id and secret to obtain an access token.

Combine your client id and secret into a string, separated by colon yourClientId:YourClientSecret and encode with Base64. This will result in one long string.

Make a call to https://identity.apaleo.com/connect/token, passing the encoded client credentials in the basic authorization header:

curl -X POST -d "grant_type=client_credentials" -H "content-type: application/x-www-form-urlencoded" -H "Authorization: Basic <your encoded credentials>" https://identity.apaleo.com/connect/token

Step 2: The connect/token endpoint will return the access token to pass in the header for all calls to the API, like so:

Authorization: Bearer <your token>

There's a ton of tooling based on Swagger, that lets you generate clients in different languages. We recommend you check that out, before you start from scratch.

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 Benjamin Schmid

10/10/2019

IBE Integration Guide

Let's talk Internet Booking Engines (IBEs). They work best when directly connected to the PMS, without any intermediaries that might get in the way with delays ...

by Andrea Stubbe

06/13/2019

Digital guest journey with apaleo

apaleo is building software for hotels, and our users are people that work at hotels. To create amazing guest experiences we need you, creators of guest facing ...

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 ...

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...