Holaspirit is based on an open API REST to allow you to integrate it to all your favorite web application.

Would you like to use our API? Conditions apply. Drop us a ligne at hello at holaspirit.com.

Detailed version of how to use our API is available on GitHub : https://github.com/holaSpirit/holaspirit-docs/blob/master/api.md

A short version follows : 

1. Obtain an access token

POST https://app.holaspirit.com/oauth/v2/token

Parameters:

client_id: Required OAuth2 Client ID
client_secret: OAuth2 Client secret
grant_type: OAuth2 grant
type: "password" or "refresh_token"
username: Email
password: Password
timezone: Timezone (e.g.: "+02:00") 

The client secret is not required for a public app.

The default and public Client ID is: 54cb79d0279871e1248b4567_400tdzqbdcowsskk08gws0wkwogck00w084w4s8w8gok08s0o8.

Response

{
    "access_token": "#################",
    "expires_in": 3600,
    "token_type": "bearer",
    "scope": null,
    "refresh_token": "#################"
}

Response errors

Incorrect Client ID (status code: 400):

{
    "error": "invalid_client",
    "error_description": "The client credentials are invalid"
}

Incorrect credentials (status code: 400):

{
    "error": "invalid_grant",
    "error_description": "Invalid username and password combination"
}

2. Once authenticated, you can use all endpoints listed in the documentation: 

https://app.holaspirit.com/api/doc/

Did this answer your question?