Have a lookYou can find all of apaleo's API on api.apaleo.io. We use Swagger to describe it, and to generate our documentation.
The first step is to sign up for an account. After you finish signup you will be able to login to our apaleo app and start configuring your properties. Also you can use the same credentials to access our API using Swagger.
Get access for appWe're still new and want to get in touch with you before we grant you access. Contact us at email@example.com, to get your very own client credentials that lets you play with the API in our sandbox.
Use itapaleo 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. Don't have one? Contact us at firstname.lastname@example.org.
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.io/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.io/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.