LogoLogo
ProductsUse casesDocsSupport
  • Introducing DriveKit
  • DriveKit Guides
  • Get started with drivekit
    • Trip recording lifecycle
    • iOS
      • 🚀Quick start
      • Advanced configurations
      • References
      • iOS DriveKit Demo App
    • Android
      • 🚀Quick start
      • Advanced configurations
      • References
      • Android DriveKit Demo App
      • Android 15 Migration guide
      • Android 14 Migration guide
      • Troubleshooting
  • Trip analysis
    • Introduction
    • iOS
      • Permissions
      • Trip management
      • TripListener
      • Crash Detection
      • Beacon usage
      • Bluetooth usage
      • Custom metadata
      • References (iOS)
    • Android
      • Runtime permissions
      • Trip management
      • TripListener
      • Crash Detection
      • Beacon usage
      • Bluetooth usage
      • Custom metadata
      • References (Android)
    • User interface
      • iOS
        • Get started
        • Working hours
        • Driver alert in case of crash
        • Trip recording widget
        • Location sharing
      • Android
        • Get started
        • Working hours
        • Driver alert in case of crash
        • Trip recording widget
        • Location sharing
    • REST services
      • Trip
      • References
    • Trip Simulator
      • iOS
      • Android
  • PERMISSIONS UTILS
    • Introduction
    • User interface
      • iOS
        • Get started
        • Main configurations
      • Android
        • Get started
        • Main configurations
  • COMMON UI
    • Introduction
    • iOS
      • Get started
    • Android
      • Get started
    • References
  • DRIVER DATA
    • Introduction
    • iOS
      • Get started
      • References (iOS)
    • Android
      • Get started
      • References (Android)
    • User interface
      • iOS
        • Get started
        • Advanced configurations
        • Trips widgets
        • My Synthesis
        • My Driver Profile
      • Android
        • Get Started
        • Advanced configurations
        • Trips widgets
        • My Synthesis
        • My Driver Profile
  • Driver Data Timeline UI
    • Introduction
    • iOS
      • Get started
    • Android
      • Get started
  • Vehicle
    • Introduction
    • iOS
      • Get started
      • Vehicle management
      • Beacon management
      • Bluetooth device management
      • Odometer
      • References (iOS)
    • Android
      • Get started
      • Vehicle management
      • Beacon management
      • Bluetooth device management
      • Odometer
      • References (Android)
    • User interface
      • iOS
        • Get started
        • Main configurations
        • Advanced configurations
      • Android
        • Get started
        • Main configurations
        • Advanced configurations
  • DRIVER ACHIEVEMENT
    • Introduction
    • iOS
      • Get started
    • Android
      • Get Started
    • User interface
      • iOS
      • Android
  • CHALLENGE
    • Introduction
    • Important challenge rules
    • iOS
      • Get started
      • References (iOS)
    • Android
      • Get started
      • References (Android)
    • User interface
      • iOS
        • Get started
      • Android
        • Get started
  • GROUP
    • Introduction
    • iOS
      • Get started
    • Android
      • Get started
  • React Native
    • Get started
    • Integration
  • Flutter
    • Get started
    • Integration
  • Push services
    • Introduction
    • Push Trip Data
    • Push Deleted trip
    • Push Crash Data
    • Push Diagnosis Data
  • ADMIN SERVICES
    • Beacon
      • Add
      • Replace
      • Delete
      • Configuration
    • Challenges
      • List of challenges
      • Challenge details
      • Registered users
      • Challenge ranking
      • Users' progress
      • Definitions
    • Customer
      • Activity timeline
    • Driver
      • Timeline
      • Synthesis
      • Identity
      • Status
      • Add or update a metadata
      • Vehicles
      • Profile
      • Application diagnoses
    • Drivers
      • Account
      • Statistics
      • Ranking
      • Expired accounts
    • Group
      • Timeline
      • Synthesis
    • Trips
      • Add or update a metadata
      • Delete a metadata
    • Vehicle
      • Create
      • Characteristics
      • Configuration
      • Statistics
      • Update mileage
      • Tire and brake wear update
      • References
  • Crashes
    • Annotate a crash
    • Revoke crash location URL
  • ENTERPRISE SERVICES
    • Introduction
    • Teams
      • Create a team
      • List of teams
      • Enable or disable a team
    • Hyper-admins
      • Create a hyper-admin
      • List of hyper-admins
      • Delete a hyper-admin
    • Monitoring
      • Get a push trip data report
      • Get a push crash data report
      • Request to retry failed trips
      • Request to retry failed crashes
      • Get the status of a task
  • Release notes
    • Changelog
      • iOS
      • Android
      • UI iOS
      • UI Android
Powered by GitBook
On this page
  • Configuration
  • Security
  • Recommended solution: OAuth 2.0 authorization
  • Alternative solution: Basic Auth
  • Automatic retry

Was this helpful?

Export as PDF
  1. Push services

Introduction

PreviousIntegrationNextPush Trip Data

Last updated 6 months ago

Was this helpful?

DriveQuant offers a range of services designed to integrate the data collected by our telematics solution directly into your platform. This data can be used to analyze driver behavior, manage claims and diagnose the performance of your DriveKit SDK-enabled mobile application.

We provide the following data integration services to transfer key information to your platform or data lake:

  1. The , which includes raw data recorded by the phone's sensors, driving behavior indicators and multiple trip statistics.

  2. The , which declares that a trip has been deleted on the DriveQuant platform, and informs you to replicate this deletion if the trip had also been saved on your platform.

  3. The , which includes accident data detected by the DriveKit SDK, and is generally used for assistance or claims management.

  4. The , which includes data on the configuration and status of the phone on which a mobile application integrating the DriveKit SDK is installed.

Configuration

Each push service will send data to a specific URL on your platform. The URL must be provided to DriveQuant in order to set up and activate the push services.

It is mandatory to configure the HTTP response code. If the request to your service is accepted, we expect a http status code 200 (OK). Any other code will be considered as a failure, and the service may attempt to send the data again as defined in the .

If the service returns a 200 HTTP code while the data has not been accepted by your platform, then there will be no further attempt to send the data.

Security

The data sent over the push services may include driver’s private information (location, username, email...). For this reason, the two following security measures are mandatory:

  • The provided URL must be using TLS (> 1.2) protocol (HTTPS).

  • The service must be authenticated using OAuth2 (our recommended and preferred solution) or Basic Auth

The OAuth2 configuration is shared between all the push services, and is our recommended solution.

Recommended solution: OAuth 2.0 authorization

The OAuth 2.0 configuration requires an additional endpoint, which will be used to retrieve an authorization token. This endpoint must be secured with Basic Auth. For the configuration of the push service, you will be required to provide the following information:

  • url: URL used to generate bearer token

  • clientId: client id used in basic authentication

  • clientSecret: client secret used in basic authentication

Additionally, specific headers or query parameters can be provided, if the OAuth2 endpoint requires it:

  • headers: Headers added to the request

  • params: Parameters added to the request

The token will be renewed if the push data service returns an http status code 401 or 403, depending on the endpoint configuration.

Alternative solution: Basic Auth

The Basic Authentication is a simple authentication scheme but less secure than the OAuth 2.0 protocol. For the configuration of the push service, you will be required to provide the following information:

  • username: username associated with the Basic Auth

  • password: password associated with the Basic Auth

Automatic retry

DriveQuant will retry to push the data if an HTTP error occurs during the first attempt. Each service has a specific retry policy, please refer to the relevant section.

push trip data
push deleted trip
push crash data
push diagnosis data
Automatic retry section