WebAPI - How to get the locations an employee has access to?

The method returns the location list and the access level the employee has access to.

 The method to be used to get the location list and the access level the employee has access to is:

GET

 /api/mytenant/myorganization/settings/assetsByUsers/getLocationsByUser?username=user@domain.com&modifiedOn=2020-11-20T09:55:33.396836+00:00&maxRecords=100

 The method parameters are optional. If the parameter maxRecords is not specified, it returns a maximum of 100 records. The logic is the following:

1. username: returns all the location this employee has access to, this parameter should be the employee email.
   
2. modifiedOn: returns all the location  changed with a date after the introduced date.
   
3. maxRecords: this parameter is used to place a limit to the data to be obtained. This parameter must be an integer, equal or inferior to 100.

The server returns a HttpStatusCode.OK response, with the equipment list and its access levels.

The method data structure is the following:

1. {
   
   "accessLevels": [
   
   {
   
     "accessLevelId": "3aa1a912-010c-4af3-97b8-2e7b1544f363",
   
     "accessLevel": "T", 
     "acessLevelModifiedOn":"2020-11-20T09:55:33.396836+00:00"
   
   },
   
   {
   
     "accessLevelId": "c1474504-aa6c-4a5c-b9c8-fa302195e3c7",
   
     "accessLevel": "G", 
     "acessLevelModifiedOn":"2020-11-20T09:55:33.396836+00:00"
   
   }
   
   ],
   
   "locationKey": "AUD",
   
   "description": "Auditorium",
   
   "id": "2a99cf7c-90dd-4df1-8c04-43a6a924c6a0",
   
   "isActive": true,
   
   "modifiedOn": "2020-11-17T11:02:21.0713241+00:00",
   
   "isUpTime": true,
   
   "criticality": "0000000001",
   
   "barcode": null,
   
   "parentLocationDesc": "1st Floor",
   
   "parentLocation": "F01",
   
   "locationFunctionDesc": "Conference Room",
   
   "locationFunction": "CR",
   
   "responsible": null,
   
   "countryDesc": null,
   
   "country": null,
   
   "latitud": null,
   
   "longitud": null
   
   }

On the modifiedOn parameter it will be necessary to have the html encoding into account, the "+" is replaced by "%2b".

If the inserted date on the "modifiedOn" search parameter is superior or equal to the "acessLevelModifiedOn" date, it will present the value "0001-01-01T00:00:00+00:00".

• Related Articles

• WebAPI - How to get the equipment an employee has access to?

  The method returns the equipment list and the access level the employee has access to.  The method to be used to get the equipment list and the access level the employee has access to is: GET ...

• WebAPI - How to get the tools an employee has access to?

  The method returns the tool list and the access level the employee can access. The method to be used to get the tool list and the access level the employee can access is: GET ...

• WebAPI – Get requests created by an employee

  This method returns the list of internal requests created by employees. The method to be used to get the filtered list of requests created by employee is: GET ...

• WebAPI – How do I get work orders assigned to user?

  This method returns the work orders list assigned to each employee of a specific company. The method to be used to get the work orders list assigned to the employee is: GET ...

• WebAPI – Get Work Orders assigned to the employee

  This method returns the work orders list assigned to each employee of a specific company. The method to be used to get the work orders list assigned to the employee is: ...