Telematicssdk

Quick start - Telematics SDK

Introduction We have prepared a set of APIs for quick start to integrate telematics SDK that powers mobile telematics inside 3rd party mobile applications. *…

IoT & devices#openapi#iot

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Introduction

We have prepared a set of APIs for quick start to integrate telematics SDK that powers mobile telematics inside 3rd party mobile applications.

Overview

Datamotion provides telematics infrastructure for mobile applications.

Telematics SDK turns any smartphone into telematics data gathering device to collect Location, driving and behavior data. API services unlocks power of your mobile application

There are 3 groups of methods:

  • 1 - user management
  • 2 - statistics for mobile app
  • 3 - statistics for back-end(s)

in certain cases you will need SNS or any other notification services. read more here

Possible architecture

There are three common schemes that are used by our clients. These schemes can be combined

  • Collect, Process, Store (required: 1&2)
  • Collect, Process (required: 1& sns)
  • Collect (required 1&sns)

Collect, Process, Store

Collect, Process

Collect


Common use-cases:

  • Safe and efficient driving
  • Usage-based insurance
  • Safe driving assessment
  • Driver assessment
  • Trip log
  • Geo-analysis
  • Accident monitoring
  • Driving engagements
  • Location based services
  • Realtime Tracking

and beyond

How to start

Authentication

To create a user on datamotion platform, you require to use InstanceID and InstanceKEY. You can get it in Datahub -> management -> user-service credentials

Once you create a user, you will get Device token, JWT token and refresh token. then, you will use it for APIs

Endpoints 9

2. For mobile app (Optional)

  • GETTrips - trip details/mobilesdk/stage/track/get_track/v1?trackToken=Trips - trip details
  • GETUser safe scoring - Accumulated value - v1/Scorings/individual/statistics/v1/Scorings/individual/?startDate=2021-01-01&endDate=2021-01-30Safe driving score API. This API is a part of Telematics API that we provide to our clients. Rating description presents the universal approach, developed by…
  • GETUser safe scoring - daily value - /v1/Scorings/individual/daily/statistics/v1/Scorings/individual/daily?Tag=&StartDate=2021-01-01&EndDate=2021-01-20User safe scoring - daily value - /v1/Scorings/individual/daily
  • GETUser statistics - Accumulated value - /v1/Statistics/individual/statistics/v1/Statistics/individual/?startDate=2021-01-01&endDate=2021-01-30User statistics - Accumulated value - /v1/Statistics/individual
  • GETUser statistice - Daily value - v1/Statistics/individual/daily/statistics/v1/Statistics/individual/daily/?startDate=2021-03-30&endDate=2021-03-30User statistice - Daily value - v1/Statistics/individual/daily

3. For back-end (Optional)

  • GET/v1/Scorings/consolidated/statistics/v1/Scorings/consolidated?DeviceToken=&StartDate=2021-01-17T01:04:22.840Z&EndDate=2021-01-18T01:04:22.840Z&Tag=&InstanceId=&AppId=&CompanyId=/v1/Scorings/consolidated
  • GET/v1/Scorings/consolidated/daily/statistics/v1/Scorings/consolidated/daily?DeviceToken=&StartDate=2021-01-17T01:04:22.840Z&EndDate=2021-01-18T01:04:22.840Z&Tag=&InstanceId=&AppId=&CompanyId=/v1/Scorings/consolidated/daily
  • GET/v1/Statistics/consolidated/statistics/v1/Statistics/consolidated?DeviceToken=&StartDate=2021-01-18&EndDate=2021-03-18&Tag=&InstanceId=&AppId=&CompanyId=/v1/Statistics/consolidated
  • GET/v1/Statistics/consolidated/daily/statistics/v1/Statistics/consolidated/daily?DeviceToken=&StartDate=2021-01-17&EndDate=2021-01-18&Tag=&InstanceId=&AppId=&CompanyId=/v1/Statistics/consolidated/daily

API details

Base URL
https://api.telematicssdk.com
https://mobilesdk.telematicssdk.com
Authentication
None declared in the description
Operations
9 operations on 9 pathsGET 9
Main resources
2. For mobile app (Optional) 53. For back-end (Optional) 42.1. User statistics (Optional) 22.4. User safe scoring (Optional) 2Consolidated safe scoring 2Consolidated statistics 22.2. User trips (Optional) 1
Response formats
application/json text/plain
Description format
OpenAPI 3.0.3, API version 1.0.0
Listed from
APIs.guru OpenAPI Directory (CC0-1.0)
Source updated

How to test the Quick start - Telematics SDK in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Quick start - Telematics SDK collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “Trips - trip details” (GET /mobilesdk/stage/track/get_track/v1?trackToken=), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Quick start - Telematics SDK?

Introduction We have prepared a set of APIs for quick start to integrate telematics SDK that powers mobile telematics inside 3rd party mobile applications. *… It is listed under IoT & devices and has 9 endpoints.

Who publishes the Quick start - Telematics SDK?

It is listed from Telematicssdk's public API description (an OpenAPI document), not published by Telematicssdk on Swastik Codes. Anyone who controls telematicssdk.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Quick start - Telematics SDK?

Its description lists 2 base URLs: https://api.telematicssdk.com, https://mobilesdk.telematicssdk.com. The first is the usual one; the others are typically sandbox or regional servers.

How do I authenticate with the Quick start - Telematics SDK?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the Quick start - Telematics SDK have?

9 operations on 9 paths (9 GET). The largest groups are 2. For mobile app (Optional), 3. For back-end (Optional), 2.1. User statistics (Optional), 2.4. User safe scoring (Optional).

Is forking the Quick start - Telematics SDK free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.