How to authenticate
You will need a JWT token to make a request. The JWT token is valid for ~15m.
...
Timetracker API Base URL
All requests need to be made to this base URL:
https://
...
jttp-cloud.
...
everit.
...
biz/
...
timetracker/
...
Make a GET request with Basic Authorization to the specified URL with the following credentials in the authorization request header:username = Your email adress / usernamepassword = The Atlassian API token
| Code Block |
|---|
https://<your_instance>.atlassian.net/plugins/servlet/ac/org.everit.jira.timetracker.plugin/timetracker-page?classifier=json |
...
Get the contextJwt property from the response.
...
api/latest
| Info |
|---|
REST API versions and differences: API Versions |
Available Endpoints
How to authenticate
To authenticate yourself while making requests to Timetracker's API backend, you will need an API Token.
To obtain an API Token:
| Info |
|---|
Note: API Token creation must be enabled in Timetracker by an admin first. |
Navigate to the "My Preferences" page within Timetracker and switch to the "REST API" tab.
Provide a name for the new token to help you identify it in the future, and then click the "+" button to create it.
Copy the newly created token presented in the dialog. Please note that the token will not be displayed again in the future, so if you lose it, you will need to create another one.
...
Ensure that you keep your API Tokens secure, just as you would with your passwords. They are used for authentication, and if someone else gains access to your token, they can act on your behalf within Timetracker.
For every request you make to Timetracker's API, you must include the token in the x-everit-
...
| Info |
|---|
In the future, we plan to simplify the solution by removing the step of acquiring a JWT token. |
Timetracker Cloud App Base URL
All requests need to be made to this base URL:
api-key header.
JWT Authentication
If you’re looking for the now-deprecated JWT token-based authentication method, you can find it here.
Example
CURL
| Code Block | ||
|---|---|---|
| ||
curl https://jttp-cloud.everit.biz/timetracker/api/latest |
...
| Info |
|---|
REST API versions and differences: API Versions |
Available Endpoints
...
...
...
...
/public/worklog?worklogId=10000 \
-H "X-Everit-API-Key: <your API token>" \
-H "X-Timezone: <your timezone, ex. Europe/Budapest>" |
JAVASCRIPT
| Code Block | ||
|---|---|---|
| ||
const response = await fetch(
"https://jttp-cloud.everit.biz/timetracker/api/latest/public/worklog?worklogId=10000",
{
headers: {
"X-Everit-API-Key": "<your API token>",
"X-Timezone": "<your timezone, ex. Europe/Budapest>",
},
},
); |
Output Format
Unless stated otherwise, the output format of the response data is JSON.