Info
Created 24-08-2020 by Lavinia
Gheghea
Revision
Description
The API
allows you to create, delete,
and update departments.
You can retrieve individual
department as well as a list
of all
departments.
Endpoints
GET: /departments
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 |
| 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/departments" -H "accept: */*" -H "UID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -H "DEVICEID:demo@smarttid.dk" -H "API-Key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
200 (OK) : array of
departments
Response body
[{"ID": 25020,"DepartmentCode": "DENMARK","Name": "Denmark"},{"ID": 25022,"DepartmentCode": "GERMANY","Name": "Germany"},]
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} : /departments/{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 department | Integer |
Curl example
curl -X GET "https://smartapi.smarttid.dk/departments/id" -H "accept: */*" -H "UID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -H "DEVICEID:demo@smarttid.dk" -H "API-Key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
200 (OK) : the department
Response Body
[{"ID": 25020,"DepartmentCode": "DENMARK","Name": "Denmark"}]
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: /departments
Parameters
| Name | Description | Type |
| API-key - required | Authorization Token | String(64) |
| UID - required | UID -how can be obtained | String |
| DEVICEID - required | DEVICEID | String |
Request body
{ "sDepartmentCode": "string", "sName": "string" }
Curl example
curl -X POST "https://smartapi.smarttid.dk/departments" -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 "{\"sDepartmentCode\":\"12345\",\"sName\":\"test\"}"
Response
200 (OK) : The ID of the new
department
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}: /departments/{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 department | Integer |
Request body
{ "sDepartmentCode": "string", "sName": "string" }
Curl example
curl -X GET "https://smartapi.smarttid.dk/departments/id" -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 "{\"sDepartmentCode\":\"string\",\"sName\":\"string\"}"
Response
200 (OK) : success
400 (ERROR) : Error message
Response Body
Error message
DELETE{id}: /departments/{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 department | Integer |
Curl example
curl -X GET "https://smartapi.smarttid.dk/departments/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
Department
| Name | Description | Type |
| sDepartmentCode | Code of department | String |
| sName | Name of department | String |