Info
Created 24-08-2020 by Lavinia
Gheghea
Revision
Description
The API
allows you to create, delete,
and update districts.
You can retrieve individual
district as well as a list
of all
districts.
Endpoints
GET: /districts
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/districts" -H "accept: */*" -H "UID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -H "DEVICEID:demo@smarttid.dk" -H "API-Key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
200 (OK) : array of districts
Response body
[{"ID": 1,"DistrictCode": "TEST","Name": "Test district"},{"ID": 2,"DistrictCode": "1234","Name": "test"},]
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} : /districts/{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 district | Integer |
Curl example
curl -X GET "https://smartapi.smarttid.dk/districts/id" -H "accept: */*" -H "UID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -H "DEVICEID:demo@smarttid.dk" -H "API-Key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
200 (OK) : the district
Response Body
[{"ID": 1,"DepartmentCode": "TEST","Name": "Test district"}]
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: /districts
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
{ "sDistrictCode": "string", "sName": "string" }
Curl example
curl -X POST "https://smartapi.smarttid.dk/districts" -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 "{\"sDistrictCode\":\"12345\",\"sName\":\"test\"}"
Response
200 (OK) : The ID of the new
district
Response Body
[ { "ID": 4 } ]
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}: /districts/{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 district | Integer |
Request body
{ "sDistrictCode": "string", "sName": "string" }
Curl example
curl -X PUT "https://smartapi.smarttid.dk/districts/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 "{\"sDistrictCode\":\"string\",\"sName\":\"string\"}"
Response
200 (OK) : success
400 (ERROR) : Error message
Response Body
Error message
DELETE{id}: /districts/{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 district | Integer |
Curl example
curl -X DELETE "https://smartapi.smarttid.dk/districts/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
District
| Name | Description | Type |
| sDistrictCode | Code of district | String |
| sName | Name of district | String |