Blikk API Changelog

Versions

Version 2.0.2.2

Released 2022-05-03
Added
  • Additions for endpoint "GET /v1/Core/Projects":
    • Added some additional address properties to "location" property in response object:
      • streetAddress
      • postalCode
      • city
      • countryName

Version 2.0.2.1

Released 2022-04-08
Added
  • Additions for endpoint "GET /v1/Core/Projects":
    • Added property "location" to response object:
      "location": { "objectName": "project.list.location", "longitude": 21.48181104660036, "latitude": 65.3175658912035 },

Version 2.0.2.0

Released 2022-03-17

This release includes breaking changes as we have made the property "project"/"projectId" nullable on the request/response objects for all endpoints in the time reports module.

Added
  • New list endpoint for Internal projects, "GET /v1/Admin/InternalProjects".
  • New list endpoint for Absence projects, "GET /v1/Admin/AbsenceProjects".
  • Additions for endpoint "GET /v1/Core/TimeReports":
    • Added filter parameter "filter.internalProjectId".
    • Added filter parameter "filter.absenceProjectId".
    • Added filter parameter "filter.projectType".
    • Added property "internalProject" to response object.
    • Added property "absenceProject" to response object.
  • Additions for endpoint "GET /v1/Core/TimeReports/:id":
    • Added property "internalProject" to response object.
    • Added property "absenceProject" to response object.
  • Additions for endpoint "POST /v1/Core/TimeReports":
    • Added property "internalProjectId" to request object.
    • Added property "absenceProjectId" to request object.
  • Additions for endpoint "PUT /v1/Core/TimeReports/:id":
    • Added property "internalProjectId" to request object.
    • Added property "absenceProjectId" to request object.
Modified
  • Changes for endpoint "GET /v1/Core/TimeReports":
    • Property "project" in response object will now be NULL if the time report is registered to either an internal project or absence project.
  • Changes for endpoint "GET /v1/Core/TimeReports/:id";
    • Property "project" in response object will now be NULL if the time report is registered to either an internal project or absence project.
  • Changes for endpoint "POST /v1/Core/TimeReports":
    • Property "projectId" on request object is now nullable.
    • Added property "internalProjectId" to request object.
    • Added property "absenceProjectId" to request object.
  • Changes for endpoint "PUT /v1/Core/TimeReports/:id":
    • Property "projectId" on request object is now nullable.
    • Added property "internalProjectId" to request object.
    • Added property "absenceProjectId" to request object.

Version 2.0.1.0

Released 2021-12-29

This release includes breaking changes as we have cleaned up three naming errors and added a new endpoint to the user module.
We have renamed "Project" * to "Project collection" *, "Work order" to "Project" and "Work activity" to "Activity".

* The module "Project collection" (former "Project") does not exist yet, but some models included a "ProjectId" which is renamed to "ProjectCollectionId".

So in conclusion:

  1. 'Project' --> 'Project collection'
  2. 'ProjectId' --> 'ProjectCollectionId'
  3. 'Work order' --> 'Project'
  4. 'WorkOrderId' --> 'ProjectId'
  5. 'Work activity' --> 'Activity'
  6. 'WorkActivityId' --> 'ActivityId'

The following modules are affected: Time reports, Task boards, Tasks, Projects (formerly Work orders) and Activities.
Details are listed below.

Added
  • New detail endpoint for Users, "GET /v1/Admin/Users/:id".
Modified
  • Renamed former "Work orders" module to "Projects", "GET /v1/Core/WorkOrders" is now "GET /v1/Core/Projects".
    Other changes to this endpoint includes:
    • Property "objectName" in response model for "GET /v1/Core/Projects" has changed from "workorder.list" to "project.list".
    • Property "project" in the reponse model "project.list" has been changed to "projectCollection".
    • Property "status.objectName" in response model "project.list" has changed from "workorder.list.status" to "project.list.status".
  • Changes for endpoint "GET /v1/Core/TimeReports":
    • Filter parameter "filter.workOrderId" has been changed to "filter.projectId".
    • Property "workOrder" in the reponse model "timereport.list" has been changed to "project".
    • Property "workActivity" in the reponse model "timereport.list" has been changed to "activity".
  • Changes for endpoint "GET /v1/Core/TimeReports/:id":
    • Property "workOrder" in the reponse model "timereport.detail" has been changed to "project".
    • Property "workActivity" in the reponse model "timereport.detail" has been changed to "activity".
  • Changes for endpoint "POST /v1/Core/TimeReports":
    • Property "workOrderId" in the request model has been changed to "projectId".
    • Property "workActivityId" in the request model has been changed to "activityId".
  • Changes for endpoint "PUT /v1/Core/TimeReports/:id":
    • Property "workOrderId" in the request model has been changed to "projectId".
    • Property "workActivityId" in the request model has been changed to "activityId".
  • Changes for endpoint "GET /v1/Core/TaskBoards":
    • Filter parameter "filter.workOrderId" has been changed to "filter.projectId".
    • Property "workOrder" in the reponse model "taskboard.detail" has been changed to "project".
  • Changes for endpoint "GET /v1/Core/Tasks":
    • Property "project" in the reponse model "task.list" has been changed to "projectCollection".
    • Property "workOrder" in the reponse model "task.list" has been changed to "project".
  • Changes for endpoint "POST /v1/Core/Tasks":
    • Property "workOrderId" in the request model has been changed to "projectId".
  • Changes for endpoint "PUT /v1/Core/Tasks/:taskId":
    • Property "workOrderId" in the request model has been changed to "projectId".
  • Renamed former "Work activities" module to "Activities", "GET /v1/Admin/WorkActivities" is now "GET /v1/Admin/Activities".
    Other changes to this endpoint includes:
    • Property "objectName" in response model for "GET /v1/Admin/Activities" has changed from "workactivity.list" to "activity.list".
  • Persmission "WorkOrder_Read" has been changed to "Project_Read" (no action required).

Version 2.0.0.2

Released 2021-12-09

This release includes some minor bugfixes in the Task and Contact modules.

Bugfixes
  • Fixed an issue that was caused by a historical bug in the contact registry. The issue resulted in a status 500 Internal Server Error for some consumers when calling endpoint "GET /v1/Core/Contacts".
  • Fixed a bug when fetching tasks ("GET /v1/Core/Tasks"). The issue occurred if the list of tasks contained atleast one task where either the user that created the task was deleted, if the workorder that the task was connected to was deleted or if the opportunity that the task was connected to was deleted. The result was a status 500 Internal Server Error.

Version 2.0.0.1

Released 2021-12-06

This release includes changes to the GUI of the API documentation aswell as some minor changes to the API. The changes to the API includes some new filter options for some endpoints and a new read-permission (WorkOrder_Read) for the Work order module.

Added
  • New permission "WorkOrder_Read" available for API-applications in the API management portal.
  • New property "Tags" included in "taskboard.list" response for endpoint "GET /v1/Core/TaskBoards".
  • New filter option for endpoint "GET /v1/Admin/Users":
    • Ability to filter users based on their name with "filter.query".
  • New filter options for endpoint "GET /v1/Core/Tasks":
    • Ability to filter tasks based on an array of task ids with "filter.taskIds".
    • Ability to filter tasks that belongs to a specific task board with "filter.taskBoardId".
    • Ability to filter tasks that belongs to a specific task board column with "filter.taskBoardColumnId".
Modified
  • Endpoint "GET /v1/Core/WorkOrders" now requires permission "WorkOrder_Read".
Bugfixes
  • Fixed a bug in model validation for endpoint "POST /v1/Core/Tasks" where if the value of properties "tagIds" or "memberIds" was "null" (empty array was fine) or if the properties was excluded in the request, the result would be a 500 Internal Server Error.
  • Fixed a bug in model validation for endpoint "GET /v1/Core/TimeReports/UserDayStatistics" where if none of the filters were supplied, the result would be a 500 Internal Server Error.

Version 2.0

Released 2021-11-08

This release marks the initial version of the new API.

Added
  • Core resource endpoints
    • Contact (list, detail, create, update, delete)
    • Time report (list, detail, create, update, delete)
    • Task (list, create, update, delete)
    • Task board (list only)
    • Work order (list only)
  • Admin resource endpoints
    • Countries (list only)
    • Contact tags (list only)
    • Users (list only)
    • Time codes (list only)
    • Time articles (list only)
    • Work activities (list only)
    • Allowances (list only)
    • Company cars (list only)
    • Equipments (list only)
    • Articles (list only)
    • Time additions (list only)