POST
/
vehicle-data
curl --request POST \
  --url https://api.mobway.cloud/vehicle-data \
  --header 'Authorization: Bearer <token>' \
  --data '{
    "vins": [
        {vins}
    ],
    "datapoints": [
        "vin",
        "date_time",
        "speed",
        "latitude",
        "longitude",
        "heading",
        "rpm",
        "mileage",
        "fuel_level",
        "range",
        "tire_pressure_front_left",
        "tire_pressure_front_right",
        "tire_pressure_rear_left",
        "tire_pressure_rear_right",
        "oil_level",
        "engine_cooling_temperature",
        "lv_battery_voltage",
        "hv_battery_voltage",
        "hv_battery_soc",
        "hv_battery_charging_status",
        "seat_belt_status",
        "event",
        "flag"
    ],
    "start_date": {start_date},
    "end_date": {end_date}
}'

{
  "6AHFT68CKAF501652": [
    {
      "vin": "6AHFT68CKAF501652",
      "date_time": "2023-02-14T09:51:48",
      "speed": 109.78,
      "latitude": 56.073055,
      "longitude": -177.689265,
      "heading": 357.92,
      "rpm": 3737.16,
      "mileage": 806942.06,
      "fuel_level": 79.79,
      "range": -75.68,
      "tire_pressure_front_left": 31.78,
      "tire_pressure_front_right": 82.57,
      "tire_pressure_rear_left": 120.08,
      "tire_pressure_rear_right": 135.14,
      "oil_level": 15.28,
      "engine_cooling_temperature": 11.4,
      "lv_battery_voltage": 20.41,
      "hv_battery_voltage": 596.41,
      "hv_battery_soc": 38.48,
      "hv_battery_charging_status": "other",
      "seat_belt_status": "not buckled",
      "event": "charging plug status change",
      "flag": []
    },
    {
      "vin": "6AHFT68CKAF501652",
      "date_time": "2023-02-14T09:51:51",
      "speed": 265.23,
      "latitude": 56.089004,
      "longitude": -177.71086,
      "heading": 357.92,
      "rpm": 5591.89,
      "mileage": 806942.21,
      "fuel_level": 21.35,
      "range": -76.13,
      "tire_pressure_front_left": 103.66,
      "tire_pressure_front_right": 27.95,
      "tire_pressure_rear_left": 74.17,
      "tire_pressure_rear_right": 76.88,
      "oil_level": 95.38,
      "engine_cooling_temperature": 129.52,
      "lv_battery_voltage": 7.9,
      "hv_battery_voltage": 500.59,
      "hv_battery_soc": 17.87,
      "hv_battery_charging_status": "charging",
      "seat_belt_status": "not buckled",
      "event": "charging plug status change",
      "flag": [
        {
          "datapoint": "hv_battery_soc",
          "value": 153.14,
          "flag": "out of range"
        }
      ]
    }
  ]
}
Apesar de ser uma requisição POST, está rota não se destina a criar um recurso na API. Foi desenvolvida desta forma pela comodidade de customizar o payload a ser enviado no corpo da requisição.

​
Request

Header
​
token
string
required

É o token ao portador utilizado para autenticar a empresa.

Body
​
vins
list of strings
required

Indica a lista de Vehicle Identification Number (VIN) dos veículos os quais se deseja recuperar os dados.

​
datapoints
list of strings
required

Indica a lista de pontos de dados que se deseja recuperar dos veículos.

​
start_date
date or datetime

É um parâmetro opcional e pode ser usado para filtrar a data de início dos dados. Deve ser enviado nos seguintes formatos: YYYY-MM-DD ou YYYY-MM-DDTHH:MM:SS (ISO 8601). Caso o formato escolhido seja YYYY-MM-DD, para os propósitos do filtro, será considerado o seguinte horário: YYYY-MM-DDT00:00:00

​
end_date
date or datetime

Também é um parâmetro opcional para filtrar a data de fim dos dados. Segue os mesmos formatos: YYYY-MM-DD ou YYYY-MM-DDTHH:MM:SS (ISO 8601). Caso o formato escolhido seja YYYY-MM-DD, para os propósitos do filtro, será considerado o seguinte horário: YYYY-MM-DDT23:59:59

Quando forem utilizados start_date e end_date, o date_time estará entre estas duas datas, da seguinte forma: end_data >= datetime >= start_date
Quando não forem utilizados, o start_date e o end_date serão, por padrão, as últimas 24 horas a partir do momento da requisição

​
Response

Para informações mais detalhadas sobre a resposta, consultar em Pontos de Dados
​
vin
string

Indica o número de identificação único do veículo.

​
date_time
datatime

Indica a data e hora do registro do conjunto de dados [YYYY-MM-DDTHH:MM:SS].

​
datapoint
number or categorical

Indica separademente cada pontos de dados.

​
flag
categorical

Indica quando um dado foi considerado como errôneo e foi corrigido, contendo o dado do qual se trata, o valor original e o tipo do erro.

curl --request POST \
  --url https://api.mobway.cloud/vehicle-data \
  --header 'Authorization: Bearer <token>' \
  --data '{
    "vins": [
        {vins}
    ],
    "datapoints": [
        "vin",
        "date_time",
        "speed",
        "latitude",
        "longitude",
        "heading",
        "rpm",
        "mileage",
        "fuel_level",
        "range",
        "tire_pressure_front_left",
        "tire_pressure_front_right",
        "tire_pressure_rear_left",
        "tire_pressure_rear_right",
        "oil_level",
        "engine_cooling_temperature",
        "lv_battery_voltage",
        "hv_battery_voltage",
        "hv_battery_soc",
        "hv_battery_charging_status",
        "seat_belt_status",
        "event",
        "flag"
    ],
    "start_date": {start_date},
    "end_date": {end_date}
}'

{
  "6AHFT68CKAF501652": [
    {
      "vin": "6AHFT68CKAF501652",
      "date_time": "2023-02-14T09:51:48",
      "speed": 109.78,
      "latitude": 56.073055,
      "longitude": -177.689265,
      "heading": 357.92,
      "rpm": 3737.16,
      "mileage": 806942.06,
      "fuel_level": 79.79,
      "range": -75.68,
      "tire_pressure_front_left": 31.78,
      "tire_pressure_front_right": 82.57,
      "tire_pressure_rear_left": 120.08,
      "tire_pressure_rear_right": 135.14,
      "oil_level": 15.28,
      "engine_cooling_temperature": 11.4,
      "lv_battery_voltage": 20.41,
      "hv_battery_voltage": 596.41,
      "hv_battery_soc": 38.48,
      "hv_battery_charging_status": "other",
      "seat_belt_status": "not buckled",
      "event": "charging plug status change",
      "flag": []
    },
    {
      "vin": "6AHFT68CKAF501652",
      "date_time": "2023-02-14T09:51:51",
      "speed": 265.23,
      "latitude": 56.089004,
      "longitude": -177.71086,
      "heading": 357.92,
      "rpm": 5591.89,
      "mileage": 806942.21,
      "fuel_level": 21.35,
      "range": -76.13,
      "tire_pressure_front_left": 103.66,
      "tire_pressure_front_right": 27.95,
      "tire_pressure_rear_left": 74.17,
      "tire_pressure_rear_right": 76.88,
      "oil_level": 95.38,
      "engine_cooling_temperature": 129.52,
      "lv_battery_voltage": 7.9,
      "hv_battery_voltage": 500.59,
      "hv_battery_soc": 17.87,
      "hv_battery_charging_status": "charging",
      "seat_belt_status": "not buckled",
      "event": "charging plug status change",
      "flag": [
        {
          "datapoint": "hv_battery_soc",
          "value": 153.14,
          "flag": "out of range"
        }
      ]
    }
  ]
}