To use the TimeTonic API, you must obtain an API key named Sesskey (session key) that must be transmitted to each request.

You can obtain an API key (Sesskey) in two ways:

1. Either directly via your User Profile
2. Either via the website dedicated to the API

Note that an API key (Sesskey) is always linked to a user account even if you use the second method. This is why we recommend using a dedicated account for API access, usually an account of the type api_<nameOfTheClient>

Warning: An API key (Sesskey) may expire. Each user, via the "Disconnect your other sessions" option of his profile, can choose to delete all other current sessions which will destroy all sessions, web, mobile and API.

For security reasons, TimeTonic also maintains the right to delete sessions without notice. Web sessions systematically have a lifetime limited to a few weeks.

1. Creating an API key (Sesskey) via your user profil

The easiest way to create an API key (Sesskey) is to access your user profile in TimeTonic and click on the "Generate" button of the "API Key (Sesskey)" option.

Your profile is easily available from the TimeTonic home menu and also at the following url: https://timetonic.com/live/nav/profile/

Once your API key (Sesskey) has been generated, simply copy it to use it in your requests via the API.

2. Creating an API key (Sesskey) via the API dedicated website

You may need to generate several API keys (Sesskey).

To generate an API key (Sesskey) via the dedicated site, several steps must be followed, in order.

Be sure to keep a note of your usernames, as they will only be generated once. If you lose a username, you will have to regenerate everything from the beginning.

Three steps are required to create an API key (Sesskey) by this method:

1. Create an Appkey
2. Create an Oauthkey
3. Create the Sesskey.

2.a. Creating the Appkey

From the API website, in createAppkey, choose a name to your application by filling in the "appname" field, then click on Submit :

Write down the values generated:

{
    "status": "ok",
    "appkey": "BsqZ-CvAm-gtRv-GU4h-8zvu-0",
    "id": "6460",
    "createdVNB": "dev-4.59b",
    "req": "createAppkey"
}

2.b. Creating the Oauthkey

From the API, in createOauthkey, fill in the fields in the red box as follows:

• login : Your TimeTonic username
• pwd : Your TimeTonic password
• appkey : The "appkey" code received upon creating the Appkey

Click afterwards on Submit:

Write down the values generated: 

{
    "status": "ok",
    "oauthkey": "xSDA-Qz8J-Bb6f-4zkf-8C3N-0",
    "id": "6286",
    "o_u": "demo",
    "createdVNB": "dev-4.59b",
    "req": "createOauthkey"
}

2.c. Creating the Sesskey

From the API dedicated website, in createSesskey, fill in the fields in the red box as follows:

• oauth_user (o_u) : your TimeTonic username
• oauthkey : the "oauthkey": code received upon creating the Oauthkey previously

Click then on Submit:

Write down the values generated:

{
    "status": "ok",
    "sesskey": "FeI7-2PgX-5fZY-lGRC-MCj4-0",
    "id": "6436",
    "createdVNB": "dev-4.59b",
    "req": "createSesskey"
}