Info

Created 13-10-2020 by Lavinia Gheghea

Revision



Description

The API allows you to create, delete, and update  employee work calendar. You can retrieve individual employee work calendar as well as a list of all employee work calendars.

Endpoints


GET:  /employeeworkcalendars?sEmployeeCode=xxxx


Parameters
Headers and Query
 Name
 Description
 Type
 API-key - required
 Authorization Token
 String(64)
 UID - required
 UID -how can be obtained
 String
 DEVICEID - required
  DEVICEID
 String
 sEmployeeCode- required
 Employee Code
 String
 offset
 starting record
 Integer
 limit
 how many records displayed on a page
 Integer
 OrderFieldName
 field name to order the recordset
 String
 OrderDirection
 ASC or DESC
 String
 Filter
 filter the recordset
 String

Curl example

curl -X GET "https://smartapi.smarttid.dk/employeeworkcalendars?sEmployeeCode=xxxx" -H "accept: */*" -H "UID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -H "DEVICEID:demo@smarttid.dk" -H "API-Key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response

200 (OK) :  array of employee work calendar

Response body
[ 
{
    "ID": 215,
    "EmployeeCode": "1009",
    "StartDate": "2019-09-11T00:00:00",
    "EndDate": "2019-10-30T00:00:00",
    "WorkCalendarCode": "1007TEST",
    "WorkShiftCode": null,
    "TemplateCode": null,
    "WorkCalendarDescription": "Løsarbejdere",
    "WorkCalendarID": 158,
    "WorkShiftDescription": null,
    "TemplateDescription": null
  },
  {
    "ID": 213,
    "EmployeeCode": "1009",
    "StartDate": "2019-08-28T00:00:00",
    "EndDate": "2019-09-06T00:00:00",
    "WorkCalendarCode": "FUNK",
    "WorkShiftCode": null,
    "TemplateCode": null,
    "WorkCalendarDescription": "Funktionærer",
    "WorkCalendarID": 98,
    "WorkShiftDescription": null,
    "TemplateDescription": null
  }
]


Response headers:
content-encoding: gzip 
 content-length: 238 
 content-type: application/json; charset=utf-8 
 date: Mon, 24 Aug 2020 08:01:23 GMT 
 server: Microsoft-IIS/10.0 
 vary: Accept-Encoding 
 x-pagination: {"totalCount":4,"totalFiltered":4,"Offset":0,"Limit":4,"Returned":4} 
 x-powered-by: ASP.NET

400 (ERROR) : Error message

Response Body
Error message


GET{id} : /employeeworkcalendars/{id}  


Parameters
 Name
 Description
 Type
 API-key - required
 Authorization Token 
 String(64)
 UID - required
UID -how can be obtained
 String
 DEVICEID - required
  DEVICEID
 String
 id- required
 ID of employee work calendar
 Integer
Curl example

curl -X GET "https://smartapi.smarttid.dk/employeeworkcalendars/id" -H "accept: */*" -H "UID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -H "DEVICEID:demo@smarttid.dk" -H "API-Key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response

200 (OK) : the employee work calendar

Response Body
[ 
{ 
"ID": 215, 
"EmployeeCode": "1009", 
"StartDate": "2019-09-11T00:00:00", 
"EndDate": "2019-10-30T00:00:00", 
"WorkCalendarCode": "1007TEST", 
"WorkShiftCode": null, 
"TemplateCode": null, 
"WorkCalendarDescription": "Løsarbejdere", 
"WorkCalendarID": 158, 
"WorkShiftDescription": null, 
"TemplateDescription": null 
}
]

Response Headers
content-encoding: gzip
  content-length: 175
  content-type: application/json; charset=utf-8 
 date: Mon, 24 Aug 2020 08:39:57 GMT 
 server: Microsoft-IIS/10.0 
 vary: Accept-Encoding  x-powered-by: ASP.NET

400 (ERROR) : Error message

Response Body
Error message


POST: /employeeworkcalendars?sEmployeeCode=xxxx


Parameters
 Name
 Description
 Type
 API-key - required
 Authorization Token 
 String(64)
 UID - required
 UID -how can be obtained
 String
 DEVICEID - required
  DEVICEID
 String
 sEmployeeCode- required
 Employee Code
 String

Request body
{
"dtStartDate": "string",
  "sWorkCalendarCode": "string",
  "sWorkShiftCode": "string",
  "sTemplateCode": "string",
  "dtEndDate": "string"
}

Curl example
curl -X POST "https://smartapi.smarttid.dk/employeeworkcalendars?sEmployeeCode=xxxx" -H "accept: */*" -H "UID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -H "DEVICEID:demo@smarttid.dk" -H "API-Key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Content-Type: application/json-patch+json" -d "{/"dtStartDate/": /"string/",/"sWorkCalendarCode/": /"string/",  /"sWorkShiftCode/": /"string/",  /"sTemplateCode/": /"string/",  /"dtEndDate/": /"string/"}"

Response

200 (OK) : The ID of the new employee work calendar

Response Body
[
 {
  "ID": 25033
 }
]
Response Headers
content-encoding: gzip 
 content-length: 138 
 content-type: application/json; charset=utf-8 
 date: Mon, 24 Aug 2020 09:24:44 GMT 
 server: Microsoft-IIS/10.0 
 vary: Accept-Encoding  x-powered-by: ASP.NET

400 (ERROR) : Error message

Response Body
Error message


PUT{id}: /employeeworkcalendars/{id}?sEmployeeCode=xxxx


Parameters
 Name
 Description
 Type
 API-key - required
 Authorization Token
 String(64)
 UID - required
UID -how can be obtained
 String
 DEVICEID - required
  DEVICEID
 String
 sEmployeeCode - required
 Employee Code
 String
 id- required
 ID of employee work calendar
 Integer

Request body
{
"dtStartDate": "string", 
"sWorkCalendarCode": "string", 
"sWorkShiftCode": "string", 
"sTemplateCode": "string", 
"dtEndDate": "string" 
}

Curl example

curl -X PUT "https://smartapi.smarttid.dk/employeeworkcalendars/id?sEmployeeCode=xxx" -H "accept: */*" -H "UID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -H "DEVICEID:demo@smarttid.dk" -H "API-Key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Content-Type: application/json-patch+json" -d "{/"dtStartDate/": /"string/",/"sWorkCalendarCode/": /"string/",  /"sWorkShiftCode/": /"string/",  /"sTemplateCode/": /"string/",  /"dtEndDate/": /"string/"}"

Response

200 (OK) : success

400 (ERROR) : Error message

Response Body
Error message


DELETE{id}: /employeeworkcalendars/{id}


Parameters
 Name
 Description
 Type
 API-key - required
 Authorization Token
 String(64)
 UID - required
 UID -how can be obtained
 String
 DEVICEID - required
  DEVICEID
 String
 id- required
 ID of employee work calendar
 Integer

Curl example

curl -X DELETE "https://smartapi.smarttid.dk/employeeworkcalendars/id" -H "accept: */*" -H "UID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -H "DEVICEID:demo@smarttid.dk" -H "API-Key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 

Response
200 (OK) :Success


400 (ERROR) : Bad request

Response Body
Error message

Response headers

content-length: 84 
 content-type: text/plain; charset=utf-8 
 date: Tue, 25 Aug 2020 08:35:21 GMT 
 server: Microsoft-IIS/10.0 
 x-powered-by: ASP.NET


Object

Employee Work Calendar
 Name
 Description
 Type
dtStartDate
 Start Date
 String
sWorkCalendarCode
Work Calendar Code
 String
 sWorkShiftCode
 Work Shift Code
 String
 sTemplateCode
 Template Code
 String
dtEndDate
End Date
 String