Versions Compared

Old Version 9

changes.mady.by.user Zsolt Nagy

Saved on

compared with

New Version Current

changes.mady.by.user Attila Bordás

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Create, Update, View or Delete worklogs with the same restrictions and rules as you would within the app.

All requests need to be made to this base URL:

https://jttp-cloud.everit.biz/timetracker/api/<REST_API_VERSION>latest/public

Create worklog POST /worklog

...

Header Parameter

Optional

Description

x-everit-jwt

false

JWT token, see: REST API

x-requested-by

false

CSRF protection parameter. Can be empty or any dummy text.

x-timezone

true

The time zone of the user, for eg.: ' Europe/Budapest'. If not specified defaults to UTC.

...

POST URL: TIME_TRACKER_BASE_URL/timetracker/api/22latest/public/worklog

Example post body:

...

Code Block
{
    "description": "my description",
    "durationInSeconds": 3600,
    "isBillable": true,
    "issueId": 10182,
    "workDate": "2023-04-24",
    "worklogId": 155,
    "worklogTagIds": [
        1,
        5
    ],
    "workStartTime": "12:00"
}

400 Invalid parameters:

An object that holds all field and non-field related errors:

Code Block
{
  "// Errors that are not tied to any specific field.
  "additionalErrors": [
    {
      "errorType": "JiraError", | "PeriodicLimit" | "PeriodicLoggablePeriod" | "PeriodicMaxHoursPerDay" | "extraTooManyDataForTimesheet": {}
    } | "TooManyWorklogsToExport" | "NoActiveLicense" | "ManualUpgradeNeeded"
   ],   "fieldErrorsextra": [// A field holding additional {information related to the error
  "errorType": "Exceed", }
  ],
  "paths": [
   // Error response data for fields.
   "fieldErrors": [
    {
      "stringerrorType": "Exceed" |  "Invalid" | "InvalidByJira" |  ]
      ]"InvalidFormat" | "LoggablePeriod" | "MaxHoursPerDay" | "Required" | "TooManyPeriodicIssues",
     } // An ]
}

401 Unauthorized

479 The user does not have one of the necessary Timetracker permissions that can be set in the Global Settings.

Update worklog PATCH /worklog

Header parameters

...

Header Parameter

...

Optional

...

Description

...

x-everit-jwt

...

false

...

JWT token, see: REST API

...

array of string arrays containing the problematic field names.
      "paths": [
        [
          "string"
        ]
      ]
    }
  ]
}

401 Unauthorized

479 The user does not have one of the necessary Timetracker permissions that can be set in the Global Settings.

Update worklog PATCH /worklog

Header parameters

Header Parameter

Optional

Description

x-everit-jwt

false

JWT token, see: REST API

x-requested-by

false

CSRF protection paramter.

x-timezone

true

The time zone of the user, for eg.: ' Europe/Budapest'. If not specified defaults to UTC.

...

PATCH URL: TIME_TRACKER_BASE_URL/timetracker/api/22latest/public/worklog

Example patch body:

...

  • If there was no error during the patch the error object will be null and the patched worklog is returned:

    • Code Block
      {
    "error": null,
    "worklog": {
        "description": "test description",
        "durationInSeconds": 10800,
        "isBillable": true,
        "issueId": 10329,
        "workDate": "2023-04-19",
        "worklogId": 181,
        "worklogTagIds": [
            1,
            5
        ],
        "workStartTime": "08:15"
    }
}

  • If there was an error during the patch the error object will be filled:

    • Code Block
      {
    "error": {
        "message": null,
        "result": "WORKLOG_NOT_FOUND",
        "worklogId": 181
    },
    "worklog": null
}

400 Invalid parameters:

An object that holds all field and non-field related errors:

Code Block
{
  // Errors that are not tied to any specific field.
  "additionalErrors": [
    {
      "errorType": "JiraError", | "PeriodicLimit" | "PeriodicLoggablePeriod"  | "extraPeriodicMaxHoursPerDay": {}| "TooManyDataForTimesheet" | "TooManyWorklogsToExport" | }"NoActiveLicense" |  ],
  "fieldErrors": ["ManualUpgradeNeeded"
     {       "errorType"extra": "Exceed",
      "paths": [
// A field holding additional information related to the error
    }
  [],
  // Error response data for fields.
  "stringfieldErrors": [
    {
  ]    "errorType": "Exceed" | "Invalid" | ]"InvalidByJira" | "InvalidFormat" | "LoggablePeriod" }| "MaxHoursPerDay" | ]
}

401 Unauthorized

479 The user does not have one of the necessary Timetracker permissions that can be set in the Global Settings.

Get worklog GET /worklog

Header parameters

...

Header Parameter

...

Optional

...

Description

...

x-everit-jwt

...

false

...

JWT token, see: REST API

...

x-timezone

...

true

...

"Required" | "TooManyPeriodicIssues",
      // An array of string arrays containing the problematic field names.
      "paths": [
        [
          "string"
        ]
      ]
    }
  ]
}

401 Unauthorized

479 The user does not have one of the necessary Timetracker permissions that can be set in the Global Settings.

Get worklog GET /worklog

Header parameters

Header Parameter

Optional

Description

x-everit-jwt

false

JWT token, see: REST API

x-timezone

true

The time zone of the user, for eg.: Europe/Budapest. If not specified defaults to UTC.

...

Query Parameter

Value type

Optional

Description

worklogId

number

false

The id of the worklog.

Example: /public/worklog?worklogId=107

Examples

GET URL: TIME_TRACKER_BASE_URL/timetracker/api/22/public/worklog?worklogId=155

Example response:

200 Successful operation:

...

Example: /public/worklog?worklogId=107

Examples

GET URL: TIME_TRACKER_BASE_URL/timetracker/api/latest/public/worklog?worklogId=155

Example response:

200 Successful operation:

Code Block
{
    "description": "my description",
    "durationInSeconds": 3600,
    "isBillable": true,
    "issueId": 10182,
    "workDate": "2023-04-24",
    "worklogId": 155,
    "worklogTagIds": [
        1,
        5
    ],
    "workStartTime": "12:00"
}

  • 400

    • Invalid parameters:

      • An object that holds all field and non-field related errors:

        Code Block
        {
  // Errors that are not tied to any specific field.
  "additionalErrors": [
    {
      "

...

      • errorType":

...

      •  "JiraError" | "PeriodicLimit" | "PeriodicLoggablePeriod" | "PeriodicMaxHoursPerDay" | "TooManyDataForTimesheet" | "TooManyWorklogsToExport" | "NoActiveLicense" | "ManualUpgradeNeeded"
      "

...

      • extra":

...

      • // A field holding additional information related to the

...

      • error

...

      • }

...

      • ],
  // Error response

...

  • 400

    • Invalid parameters:

      • Code Block
        {data for fields.
  "additionalErrorsfieldErrors": [
    {
      "errorType": "JiraErrorExceed", | "Invalid" | "InvalidByJira" |  "extraInvalidFormat": {}| "LoggablePeriod" | "MaxHoursPerDay"  }| "Required" | ]"TooManyPeriodicIssues",
  "fieldErrors": [   // An {array of string arrays containing the problematic "errorType": "Exceed",field names.
      "paths": [
        [
          "string"
        ]
      ]
    }
  ]
}

    • WorklogError:

      • Code Block
        {
    "error": {
        "message": null,
        "result": "WORKLOG_NOT_FOUND",
        "result": "WORKLOG_NOT_FOUND",
        "worklogId": 123
    }
}

401 Unauthorized

479 The user does not have one of the necessary Timetracker permissions that can be set in the Global Settings.

Delete worklog DELETE /worklog

Header parameters

...

Header Parameter

...

Optional

...

Description

...

x-everit-jwt

...

false

...

JWT token, see: REST API

...

x-requested-by

...

false

...

CSRF protection paramter.

...

x-timezone

...

true

...

The time zone of the user, for eg.: 'Europe/Budapest'. If not specified defaults to UTC.

Query Parameters

The available query parameters for the request:

...

Query Parameter

...

Value type

...

Optional

...

Description

...

worklogId

...

number

...

false

...

The id of the worklog.

Example: /public/worklog?worklogId=107

Examples

DELETE URL: TIME_TRACKER_BASE_URL/timetracker/api/22/public/worklog?worklogId=123

Example response:

200 The delete operation is accepted and processed. The result of the worklog delete can be found in the response body:

  • If there was no error during the deletion the error object will be null:

    • Code Block
      {
    "error": null
}

  • If there was an error during the deletion the error object will be filled:

    • Code Block{ "error": { 
      • worklogId": 123
    }
}

401 Unauthorized

479 The user does not have one of the necessary Timetracker permissions that can be set in the Global Settings.

Delete worklog DELETE /worklog

Header parameters

Header Parameter

Optional

Description

x-everit-jwt

false

JWT token, see: REST API

x-requested-by

false

CSRF protection paramter.

x-timezone

true

The time zone of the user, for eg.: Europe/Budapest. If not specified defaults to UTC.

Query Parameters

The available query parameters for the request:

Query Parameter

Value type

Optional

Description

worklogId

number

false

The id of the worklog.

Example: /public/worklog?worklogId=107

Examples

DELETE URL: TIME_TRACKER_BASE_URL/timetracker/api/latest/public/worklog?worklogId=123

Example response:

200 The delete operation is accepted and processed. The result of the worklog delete can be found in the response body:

  • If there was no error during the deletion the error object will be null:

    • Code Block
      {
    "error": null
}

  • If there was an error during the deletion the error object will be filled:

    • Code Block
      {
    "error": {
        "message": null,
        "result": "WORKLOG_NOT_FOUND",
        "worklogId": 123
    }
}

400 Invalid parameters:

An object that holds all field and non-field related errors:

Code Block
{
  // Errors that are not tied to any specific field.
  "additionalErrors": [
    {
      "errorType": "JiraError" | "PeriodicLimit" | "PeriodicLoggablePeriod" | "PeriodicMaxHoursPerDay" | "TooManyDataForTimesheet" | "TooManyWorklogsToExport" | "NoActiveLicense" | "ManualUpgradeNeeded"
      "

...

extra":

...

// A field holding additional information related to

...

the error
    }
  ],

...

...

 // Error response data

...

400 Invalid parameters:

Code Block
{for fields.
  "additionalErrorsfieldErrors": [
    {
      "errorType": "JiraErrorExceed", | "Invalid" | "InvalidByJira"  | "extraInvalidFormat": {}| "LoggablePeriod" | "MaxHoursPerDay" | }"Required" |  ]"TooManyPeriodicIssues",
  "fieldErrors": [   // An {array of string arrays containing the problematic "errorType": "Exceed",field names.
      "paths": [
        [
          "string"
        ]
      ]
    }
  ]
}

...