Departments¶

Department is essentially just a group of employees. They can be assigned to departments by specifying non-null department_id.

Department object¶

{
    "id": 222,
    "label": "Drivers",
    "location": {
        "lat": 46.9,
        "lng": 7.4,
        "address": "Rosenweg 3",
        "radius": 150
    }
}

• id - int. An id of department.
• label - string. Name of department.
• location - optional object. Location associated with these departments. Should be valid or null.
  • address - string. Address of the location.
  • radius - int. Radius of location zone in meters.

API actions¶

API base path: /department.

list¶

Gets all departments belonging to user.

examples¶

curl -X POST 'https://api.navixy.com/v2/fsm/department/list' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b"}'

https://api.navixy.com/v2/fsm/department/list?hash=a6aa75587e5c59c32d347da438505fc3

response¶

{
    "success": true,
    "list": [{
         "id": 222,
         "label": "Drivers",
         "location": {
             "lat": 46.9,
             "lng": 7.4,
             "address": "Rosenweg 3",
             "radius": 150
         }
    }]
}

errors¶

• 7 – Invalid parameters.
• 211 – Requested time span is too big (more than maxReportTimeSpan config option).
• 217 – The list contains non-existent entities – if one of the specified trackers does not exist, is blocked or doesn't have required tariff features.
• 221 – Device limit exceeded (if device limit set for the user’s dealer has been exceeded).

create¶

Creates a new department with specified parameters.

required sub-user rights: employee_update.

parameters¶

example¶

curl -X POST 'https://api.navixy.com/v2/fsm/department/create' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "department": {"label": "My Department", "location": {"lat": 46.9, "lng": 7.4, "address": "Rosenweg 3", "radius": 50}}'

response¶

{
    "success": true,
    "id": 111
}

• id - int. An id of the created department.

errors¶

• 7 – Invalid parameters.
• 211 – Requested time span is too big (more than maxReportTimeSpan config option).
• 217 – The list contains non-existent entities – if one of the specified trackers does not exist, is blocked or doesn't have required tariff features.
• 221 – Device limit exceeded (if device limit set for the user’s dealer has been exceeded).

update¶

Updates existing department with a new specified parameters.

required sub-user rights: employee_update.

parameters¶

example¶

curl -X POST 'https://api.navixy.com/v2/fsm/department/update' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "department": {"id": 111, "label": "My Department", "location": {"lat": 46.9, "lng": 7.4, "address": "Rosenweg 3", "radius": 50}}'

response¶

{ "success": true }

errors¶

• 201 – Not found in the database (if there is no department with specified id).

delete¶

Deletes department with the specified id.

required sub-user rights: employee_update.

parameters¶

examples¶

curl -X POST 'https://api.navixy.com/v2/fsm/department/delete' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "department_id": 111}'

https://api.navixy.com/v2/fsm/department/delete?hash=a6aa75587e5c59c32d347da438505fc3&department_id=111

response¶

{ "success": true }

errors¶

• 201 – Not found in the database (if there is no department with specified id).