Creation of an API key (Sesskey)

In order to use the TimeTonic API, you need to obtain an API key called Sesskey (session key) which must be transmitted with each request.

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

1. Either directly via your user profile
2. Or via the API dedicated website

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

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

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

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

Once your API key (Sesskey) is generated, simply copy it to use it in your API requests.

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

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

To generate an API (Sesskey) key via the dedicated site, you have to follow several steps, in order.

Remember to make a note of your identifiers as they will only be generated once. If you lose a login, you will have to regenerate everything from the beginning.

Three steps are necessary to create an API key (Sesskey) by this method: 1) the creation of an Appkey, 2) the creation of an Oauthkey, then 3) the creation of the Sesskey.

2.a. Creation of the Appkey

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

Note the values you are given:

{
"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 member name
• pwd : your TimeTonic password
• appkey : the code corresponding to "appkey":, which you have retrieved by creating the Appkey previously.

Then click on Submit :

Note the values you are given:

{
"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 site dedicated to the API, in createSesskey, fill in the fields in the red box as follows:

• oauth_user (o_u): your TimeTonic ID
• oauthkey: the code corresponding to "oauthkey" :, which you got when creating the Oauthkey previously.

Then click on Submit :

Note the values you are given, including the Sesskey :

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