Sensor actions¶

Contains API calls to interact with sensors.

Sensor sub-types:¶

Metering sensor¶

{
    "type": "metering",
    "id": 860250,
    "sensor_type": "temperature",
    "name": "OBD Coolant temperature",
    "input_name": "obd_coolant_t",
    "divider": 1.0,
    "accuracy": 0.0,
    "units": "",
    "units_type": "celsius",
    "parameters": {
      "parent_ids": [123042, 123566],
      "volume": 0.7,
      "min": 0.0,
      "max": 12.0,
      "max_lowering_by_time": 120.0,
      "max_lowering_by_mileage": 120.0
    }
}

• id - int. Sensor's id.
• sensor_type - enum
• name - string. A name of sensor.
• input_name - string.
• divider - double.
• accuracy - double. The minimum=0.0, maximum=100.0 with step 0.25.
• units - string.
• units_type - enum. Units type for a sensor.
• parameters - optional object with additional parameters.
  • parent_ids - optional array of parent_ids for composite sensor.
  • volume - double. Optional. Volume for composite sensor.
  • parent_ids - optional. int array. Array of parent_ids for composite sensor.
  • volume - optional. Double. Volume for composite sensor.
  • min - optional. Double. Min acceptable raw value for a sensor.
  • max - optional. Double. Max acceptable raw value for a sensor.
  • max_lowering_by_time - optional. Double. Max legal value lowering per hour.
  • max_lowering_by_mileage - optional. Double. Max legal value lowering per 100 km.

Discrete input¶

{
  "type": "discrete",
  "id": 888951,
  "sensor_type": "ignition",
  "name": "Ignition",
  "input_number": 4
}

• id - int. An ID of a sensor.
• sensor_type - enum. Type of the sensor.
• name - string.
• input_number - int. Assigned input number.

API actions¶

API base path: /tracker/sensor.

batch_list¶

List tracker sensors bound to trackers with specified identifiers (parameter trackers).

There exist a similar method for working with a single tracker - list.

parameters¶

response¶

Contains a map, where keys are IDs from trackers parameter and values are lists of sensor objects.

{
  "success": true,
  "result": {
    "11": [
      {
        "id": 1,
        "type": "discrete",
        "sensor_type": "fuel",
        "name": "Main tank",
        "input_name": "fuel_level",
        "group_type": null,
        "divider": 1,
        "accuracy": 0.0,
        "units": null,
        "units_type": "litre"
      }
    ]
  }
}

errors¶

• 217 - List contains nonexistent entities - if one of trackers either does not exist or is blocked.
• 221 - Device limit exceeded - if too many IDs were passed in trackers parameter.

create¶

Creates a sensor.

required sub-user rights: tracker_update.

parameters¶

examples¶

curl -X POST 'https://api.navixy.com/v2/tracker/sensor/create' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": 123456, "sensor": {"type": "metering", "id": 860250,"sensor_type": "temperature", "name": "OBD Coolant temperature", "input_name": "obd_coolant_t", "divider": 1.0, "accuracy": 0.0, "units": "", "units_type": "celsius"}'

response¶

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

• id - int. An ID of created sensor.

errors¶

• 232 - Input already in use – if given input number (for discrete input) or input name (for metering sensor) already in use.
• 208 - Device blocked – if tracker exists but was blocked due to tariff restrictions, or some other reason.
• 219 - Not allowed for clones of the device – if tracker is clone.
• 270 - Too many sensors of same type - the number of tracker's sensors, having same sensor_type is limited.

delete¶

Deletes a sensor with sensor_id from the database.

required sub-user rights: tracker_update.

parameters¶

examples¶

curl -X POST 'https://api.navixy.com/v2/tracker/sensor/delete' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": 123456, "sensor_id": 23456}'

https://api.navixy.com/v2/tracker/sensor/delete?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=123456&sensor_id=23456

response¶

{ "success": true }

errors¶

• 201 - Not found in the database - if sensor with a sensor_id is not exists or owned by other user.
• 208 – Device blocked - if tracker exists but was blocked due to tariff restrictions or some other reason.
• 219 – Not allowed for clones of the device - if tracker is clone.

list¶

List tracker sensors bound to tracker with specified ID (tracker_id parameter).

parameters¶

examples¶

curl -X POST 'https://api.navixy.com/v2/tracker/sensor/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": 123456}'

https://api.navixy.com/v2/tracker/sensor/list?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=123456

response¶

{
   "success": true,
   "list": [{
    "type": "metering",
    "id": 860250,
    "sensor_type": "temperature",
    "name": "OBD Coolant temperature",
    "input_name": "obd_coolant_t",
    "divider": 1.0,
    "accuracy": 0.0,
    "units": "",
    "units_type": "celsius" 
   }]
}

• list - list of sensor objects. See sensor object description.

errors¶

• 208 - Device blocked – if tracker exists but was blocked due to tariff restrictions, or some other reason.

update¶

Updates sensor.

required sub-user rights: tracker_update.

parameters¶

example¶

curl -X POST 'https://api.navixy.com/v2/tracker/sensor/update' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": 123456, "sensor": {"type": "metering", "id": 860250, "sensor_type": "temperature", "name": "OBD Coolant temperature", "input_name": "obd_coolant_t", "divider": 1.0, "accuracy": 0.0, "units": "", "units_type": "celsius"}'

response¶

{ "success": true }

errors¶

• 201 - Not found in the database – if sensor not exists or owned by other user.
• 232 - Input already in use – if given input number (for discrete input) or input name (for metering sensor) already in use.
• 208 - Device blocked – if tracker exists but was blocked due to tariff restrictions, or some other reason.
• 219 - Not allowed for clones of the device – if tracker is clone.

batch_copy¶

Copies sensors from one tracker to another.

required sub-user rights: tracker_update.

parameters¶

example¶

curl -X POST 'https://api.navixy.com/v2/tracker/sensor/batch_copy' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "base_tracker_id": 123456, "trackers": [56789, 54321]}'

response¶

{
    "success": true
}

errors¶

• 201 – Not found in the database - if there is no tracker with such ID belonging to authorized user.
• 272 – Trackers must have same models - if base tracker and one of target trackers has a different model.

data/read¶

Gets all metering sensor readings with values and time per requested period.

parameters¶

example¶

curl -X POST 'https://api.navixy.com/v2/tracker/sensor/data/read' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": 123456, "sensor_id": 1456789, "from": "2022-02-28 00:00:00", "to": "2022-03-28 23:59:00"}'

response¶

{
  "success": true,
  "list": [
    {
      "value": 100500,
      "get_time": "2022-02-28 00:00:00"
    },
    {
      "value": 100501,
      "get_time": "2022-02-28 00:00:30"
    }
  ]
}

errors¶

• 201 – Not found in the database - if there is no tracker with such ID belonging to authorized user.
• 211 – Requested time span is too big - if interval between "from" and "to" is too big. Maximum period is maxReportTimeSpan.
• 228 – Not supported by the sensor - if sensor is not a metering sensor.