API

Project timer

Project timer object has following params:

Param	Type	Description
username	Text	Username
startedAt	Text	Start Timestamp
workedSeconds	Integer	Last saved work duration in seconds. If current timer state is Playing / Running, then you need to calculate work duration yourself with: Difference between now and startedAt – breakSeconds = workedSeconds
breakSeconds	Integer	Last saved break duration in seconds. If current timer state is Paused / Break, then you need to calculate break duration yourself with: Difference between now and startedAt – workedSeconds = breakSeconds
playing	Boolean	flag true or false
stopped	Boolean	flag true or false
paused	Boolean	flag true or false
clientName	Text	Client name
projectName	Text	Project name
taskName	Text	Task name
note	Text	Notes

Read project timer

IMPORTANT: For each request you have to pass the local timestamp in order to get the right duration. This date must be in same timezone like you are currently, we will use it on server to calculate workedDuration and breakDuration.

curl “https://testaccount.timetrackenterprise.com/api/v2/ext/timers/project_timer?username=test&date=2020-10-23T16:00:00.000Z”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’

Start project timer

Required params to start project timer: date, clientName, projectName, username

curl -X “POST” “https://testaccount.timetrackenterprise.com/api/v2/ext/timers/project_timer/start”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{
“username”: “test”,
“clientName”: “Client 006”,
“projectName”: “Project 006_1”,
“date”: “2020-10-23T15:00:00.000Z”
}’

Pause project timer

Required params to pause project timer: date, username

curl -X “POST” “https://testaccount.timetrackenterprise.com/api/v2/ext/timers/project_timer/pause”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{
“date”: “2020-10-23T15:30:00.000Z”,
“username”: “test”
}’

Resume project timer

Required params to resume project timer: date, username

curl -X “POST” “https://testaccount.timetrackenterprise.com/api/v2/ext/timers/project_timer/resume”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{
“date”: “2020-10-23T15:30:00.000Z”,
“username”: “test”
}’

Stop project timer

Required params to stop project timer: date, username

curl -X “POST” “https://testaccount.timetrackenterprise.com/api/v2/ext/timers/project_timer/stop”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{
“date”: “2020-10-23T15:30:00.000Z”,
“username”: “test”
}’