POST api/onestop/telemetry

Post telemetry to onestop

Request Information

URI Parameters

None.

Body Parameters

OneStopTelemetry
NameDescriptionTypeAdditional information
device_id

string

None.

factory_id

string

None.

alert_id

string

None.

alert_time_utc

date

None.

device_name

string

None.

alert_name

string

None.

lat

decimal number

None.

lng

decimal number

None.

ignition_on

boolean

None.

speed_mph

integer

None.

vin

string

None.

drive_status

string

None.

drive_status_duration_s

integer

None.

external_voltage

integer

None.

odometer

integer

None.

posted_speed_limit_mph

integer

None.

device_point

DevicePoint

None.

Request Formats

application/json, text/json

Sample:
{
  "device_id": "sample string 1",
  "factory_id": "sample string 2",
  "alert_id": "sample string 3",
  "alert_time_utc": "2025-04-27T15:48:19.1108982+00:00",
  "device_name": "sample string 5",
  "alert_name": "sample string 6",
  "lat": 7.1,
  "lng": 8.1,
  "ignition_on": true,
  "speed_mph": 10,
  "vin": "sample string 11",
  "drive_status": "sample string 12",
  "drive_status_duration_s": 13,
  "external_voltage": 14,
  "odometer": 15,
  "posted_speed_limit_mph": 16,
  "device_point": {
    "device_point_id": "sample string 1",
    "dt_server": {},
    "dt_tracker": {},
    "lat": 4.1,
    "lng": 5.1,
    "altitude": {},
    "angle": {},
    "speed": {},
    "params": {},
    "device_point_external": {
      "posted_speed_limit": {},
      "software_odometer_reading": {}
    },
    "device_point_detail": {
      "factory_id": "sample string 1",
      "transmit_time": {},
      "gps_time": {},
      "acc": true,
      "lat_lng": {},
      "altitude": {},
      "speed": {
        "value": 1,
        "unit": "sample string 2",
        "display": "sample string 3"
      },
      "heading": {},
      "hdop": {},
      "num_satellites": 7,
      "remote_addr": "sample string 8",
      "hevent_list": {},
      "dtc_list": {},
      "motion_log": {
        "start_time": {},
        "end_time": {},
        "start_heading": {},
        "end_heading": {},
        "max_accelerating_force": {},
        "max_decelerating_force": {},
        "max_right_turn_force": {},
        "max_left_turn_force": {}
      },
      "packet_sequence_id": "sample string 11",
      "rssi": {},
      "trip_distance": {},
      "travel_distance": {},
      "external_volt": 13,
      "backup_battery_volt": {},
      "video_original_event": {
        "hevent_type": "sample string 1"
      },
      "remaining_battery_percent": {},
      "historic": {},
      "session_connected": {},
      "diff_corrected": {},
      "predicted": {},
      "input_1_high": {},
      "input_2_high": {},
      "input_3_high": {},
      "input_4_high": {},
      "vbus_odometer": {},
      "vbus_speed": {},
      "vbus_engine_on": {},
      "vbus_in_motion": {},
      "fuel_percent": {},
      "fuel_level_height": {},
      "fuel_temp": {},
      "eng_oil_temp": {},
      "eng_hours_total": {},
      "eng_hours_device_derived": {},
      "trans_fluid_temp": {},
      "eng_rpm": {},
      "throttle_percent": {},
      "coolant_temp": {},
      "ambient_air_temp": {},
      "vbus_avg_fuel_economy": {},
      "barometric_pressure": {},
      "vbus_calamp_indicators_0": {},
      "vbus_calamp_indicators_1": {},
      "vbus_fuel_flow": {},
      "vbus_battery_volt": {},
      "vbus_trip_fuel": {},
      "vbus_fuel_usage": {},
      "vbus_calculated_odometer": {},
      "vbus_calculated_fuel_usage": {},
      "vbus_inst_fuel_economy": {},
      "vbus_dtc_count": {},
      "throttle_valve_percent": {},
      "vbus_engine_percent_torque": {},
      "vbus_total_idle_hours": {},
      "vbus_total_idle_fuel_used": {},
      "seatbelt_fastened": {},
      "can_get_seatbelt_fastened": {},
      "change_oil_lamp_on": {},
      "oil_pressure_lamp_on": {},
      "coolant_level_percent": {},
      "intake_temp": {},
      "diesel_exhaust_volume_percent": {},
      "diesel_exhaust_2_volume_percent": {},
      "dpf_1_soot_load_percent": {},
      "dpf_2_soot_load_percent": {}
    },
    "device_state": {
      "drive_status": "sample string 1",
      "drive_status_duration": {
        "value": 1,
        "unit": "sample string 2",
        "display": "sample string 3"
      },
      "drive_status_distance": {},
      "drive_status_lat_lng_distance": {},
      "drive_status_begin_time": {},
      "best_distance_delta": {},
      "is_new_drive_status": true,
      "adjusted_lat_lng": {},
      "beyond_max_drift_distance": true,
      "prev_drive_status_duration": {},
      "prev_drive_status_distance": {},
      "prev_drive_status_lat_lng_distance": {},
      "prev_drive_status_begin_time": {},
      "prev_adjusted_lat_lng": {},
      "inaccurate_per_device_settings": true,
      "software_odometer": {},
      "last_software_odometer_reading_time": {},
      "hardware_odometer": {},
      "odometer": {},
      "computed_vbus_fuel_delta": {},
      "vin": "sample string 8",
      "debug_best_distance": {},
      "last_known_seatbelt_fastened": {}
    },
    "device_state_stale": true,
    "sequence": "sample string 11"
  }
}

application/xml, text/xml

Sample:
<OneStopTelemetry xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <DeviceId>sample string 1</DeviceId>
  <FactoryId>sample string 2</FactoryId>
  <AlertId>sample string 3</AlertId>
  <AlertTimeUtc />
  <DeviceName>sample string 5</DeviceName>
  <AlertName>sample string 6</AlertName>
  <Lat>7.1</Lat>
  <Lng>8.1</Lng>
  <IgnitionOn>true</IgnitionOn>
  <SpeedMph>10</SpeedMph>
  <Vin>sample string 11</Vin>
  <DriveStatus>sample string 12</DriveStatus>
  <DriveStatusDurationS>13</DriveStatusDurationS>
  <ExternalVoltage>14</ExternalVoltage>
  <Odometer>15</Odometer>
  <PostedSpeedLimitMph>16</PostedSpeedLimitMph>
  <DevicePoint>
    <DevicePointId>sample string 1</DevicePointId>
    <DtServer />
    <DtTracker />
    <Lat>4.1</Lat>
    <Lng>5.1</Lng>
    <Altitude />
    <Angle />
    <Speed />
    <Params />
    <DevicePointExternal>
      <PostedSpeedLimit />
      <SoftwareOdometerReading />
    </DevicePointExternal>
    <DevicePointDetail>
      <FactoryId>sample string 1</FactoryId>
      <TransmitTime />
      <GpsTime />
      <Acc>true</Acc>
      <LatLng />
      <Altitude />
      <Speed>
        <Value>1</Value>
        <Unit>sample string 2</Unit>
        <Display>sample string 3</Display>
      </Speed>
      <Heading />
      <Hdop />
      <NumSatellites>7</NumSatellites>
      <RemoteAddr>sample string 8</RemoteAddr>
      <HeventList />
      <DtcList />
      <MotionLog>
        <StartTime />
        <EndTime />
        <StartHeading />
        <EndHeading />
        <MaxAcceleratingForce />
        <MaxDeceleratingForce />
        <MaxRightTurnForce />
        <MaxLeftTurnForce />
      </MotionLog>
      <PacketSequenceId>sample string 11</PacketSequenceId>
      <Rssi />
      <TripDistance />
      <TravelDistance />
      <ExternalVolt>13</ExternalVolt>
      <BackupBatteryVolt />
      <VideoOriginalEvent>
        <HeventType>sample string 1</HeventType>
      </VideoOriginalEvent>
      <RemainingBatteryPercent />
      <Historic />
      <SessionConnected />
      <DiffCorrected />
      <Predicted />
      <Input1_High />
      <Input2_High />
      <Input3_High />
      <Input4_High />
      <VbusOdometer />
      <VbusSpeed />
      <VbusEngineOn />
      <VbusInMotion />
      <FuelPercent />
      <FuelLevelHeight />
      <FuelTemp />
      <EngOilTemp />
      <EngHoursTotal />
      <EngHoursDeviceDerived />
      <TransFluidTemp />
      <EngRpm />
      <ThrottlePercent />
      <CoolantTemp />
      <AmbientAirTemp />
      <VbusAvgFuelEconomy />
      <BarometricPressure />
      <VbusCalampIndicators0 />
      <VbusCalampIndicators1 />
      <VbusFuelFlow />
      <VbusBatteryVolt />
      <VbusTripFuel />
      <VbusFuelUsage />
      <VbusCalculatedOdometer />
      <VbusCalculatedFuelUsage />
      <VbusInstFuelEconomy />
      <VbusDtcCount />
      <ThrottleValvePercent />
      <VbusEnginePercentTorque />
      <VbusTotalIdleHours />
      <VbusTotalIdleFuelUsed />
      <SeatbeltFastened />
      <CanGetSeatbeltFastened />
      <ChangeOilLampOn />
      <OilPressureLampOn />
      <CoolantLevelPercent />
      <IntakeTemp />
      <DieselExhaustVolumePercent />
      <DieselExhaust2_VolumePercent />
      <Dpf1_SootLoadPercent />
      <Dpf2_SootLoadPercent />
    </DevicePointDetail>
    <DeviceState>
      <DriveStatus>sample string 1</DriveStatus>
      <DriveStatusDuration>
        <Value>1</Value>
        <Unit>sample string 2</Unit>
        <Display>sample string 3</Display>
      </DriveStatusDuration>
      <DriveStatusDistance />
      <DriveStatusLatLngDistance />
      <DriveStatusBeginTime />
      <BestDistanceDelta />
      <IsNewDriveStatus>true</IsNewDriveStatus>
      <AdjustedLatLng />
      <BeyondMaxDriftDistance>true</BeyondMaxDriftDistance>
      <PrevDriveStatusDuration />
      <PrevDriveStatusDistance />
      <PrevDriveStatusLatLngDistance />
      <PrevDriveStatusBeginTime />
      <PrevAdjustedLatLng />
      <InaccuratePerDeviceSettings>true</InaccuratePerDeviceSettings>
      <SoftwareOdometer />
      <LastSoftwareOdometerReadingTime />
      <HardwareOdometer />
      <Odometer />
      <ComputedVbusFuelDelta />
      <Vin>sample string 8</Vin>
      <DebugBestDistance />
      <LastKnownSeatbeltFastened />
    </DeviceState>
    <DeviceStateStale>true</DeviceStateStale>
    <Sequence>sample string 11</Sequence>
  </DevicePoint>
</OneStopTelemetry>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

None.