Auth (1.0.0)

Download OpenAPI specification:Download

This API allows you to request authentication tokens. You can also use it to generate secure URLs that are used in granting customer access to the Tilia services.

Request access token

An Access Token is a string that enables Tilia to verify that a request belongs to an authorized session. Requesting an access token requires the client ID and secret you obtained when registering as a Tilia integrator. The returned token can then be used to to make API calls.

Request
Request Body schema: application/x-www-form-urlencoded
optional
client_id
required
string <UUID4>

Your Tilia client ID.

client_secret
required
string <UUID4>

Your Tilia client secret.

grant_type
required
string

The type of token you're requesting. Must have a value of client_credentials.

scope
required
Array of strings

The scopes for the token. Refer to the documentation of the endpoint you are calling for the required scope(s).

Responses
200

Success.

400

Invalid request.

500

Service unavailable or server error

post/token
Request samples
application/x-www-form-urlencoded
client_id=3f2bfe5b-19b8-41c1-88d7-70a1586bce94&client_secret=9bc00ca4-937e-4946-bdb5-0814b603334d&grant_type=client_credentials&scope=write_registrations%2Cwrite_user_tokens%2Cuser_info
Response samples
application/json
{
  • "access_token": "eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9.eyJhY2NvdW50X2lkIjoiIiwiY2xpZW50X2lkIjoiMDRhZmJlMTctY2RlNi00OTlkLThlMTctZGExZjgwNmU3YzRkIiwiZXhwIjoxNjAwNTY0NTc2LCJpYXQiOjE2MDA1NjA5NzYsImludGVncmF0b3IiOiJ1cGxhbmQiLCJqdGkiOiIxM2Y1NDQ1Mi1kMTI4LTRmZDItODc0Ny01ZmI4NWEwYjQwZWUiLCJuYmYiOjAsInNjb3BlcyI6WyJkZWxldGVfd2FsbGV0IiwiY3JlYXRlX25vbmNlIiwicmVhZF9ub25jZSIsImRlbGV0ZV9ub25jZSIsInJlYWRfcGF5bWVudF9tZXRob2RzIiwid3JpdGVfcmVnaXN0cmF0aW9ucyIsIndyaXRlX3VzZXJfdG9rZW5zIiwidXNlcl9pbmZvIiwid3JpdGVfaW52b2ljZXMiLCJyZWFkX2t5Y3MiLCJ3cml0ZV9yZWdpc3RyYXRpb25fcHJvdmlkZXJfZGF0YSIsInNlYXJjaF9hY2NvdW50cyIsImNoYW5nZV9hY2NvdW50cyIsImJsb2NrX2FjY291bnRzIiwiY3JlYXRlX3dhbGxldCIsInJlYWRfaW52b2ljZXMiLCJyZWFkX3dhbGxldCIsIndyaXRlX3Byb2Nlc3NfY3JlZGl0cyIsInJlYWRfcHJvY2Vzc19jcmVkaXRzIl0sInRva2VuX3R5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJ1c2VybmFtZSI6IiJ9.WQo3tl1zHC2CJCJjohONiCtaPXbgnvpOqCV0Bv4sxubYiNuIa9J8j9BKTagdbd3kLHnKJLzW083mdR3UzPQbOSvBv0yzZDd-pjAnD5D0GF4y49ZOFLb2Kl_qy2c-66-D9BAS1ilwATHTiWtBcHzfh7VfTu-w9Fs3RLCHchsP0ioPsOcWzJ1BmkeuYwxXVYeaGE8vL5z26BGovFOC_SAl-V3UQFq_PnwNsame_ksKus6ayXahAXOkDyTXJkCxHHkc-08VW-JZyWWq0tQkdvZ7_H9CTThFQQ_ByCmVF9bhmf",
  • "token_type": "Bearer",
  • "expires_in": "3600",
  • "scope": "write_registrations,write_user_tokens,user_info"
}