MOVE Admin API
MOVE Backend APIs
Last updated
MOVE Backend APIs
Last updated
Registration or login of a user is equivalent to obtaining the security tokens and initialising the frontend MOVE SDK with those tokens. In other words: use the registration request to obtain the user tokens, and then forward the user tokens to your app for initializing the MOVE SDK (using a object).
POST
https://sdk.dolph.in/v20/user
This request enables users to either fetch an existing user or create a new one. The response object includes an access token, which can be used to initialize the MOVE SDK on your mobile device. This access token is valid for 5 days. The registration process supports both new and existing user IDs.
Authorization*
string
Basic <ProjectId>:<API-Key>
userId*
string
An ID for the given user should be unique
qualifier
string
GET
https://sdk.dolph.in/v20/user/authcode
The Auth Code is a unique identifier (UUID) used to initialize the SDK on the front end. This code is fetched from the backend and is valid for 10 minutes. By using the Auth Code, you simplify the process of integrating the SDK into your front-end application.
Authorization*
string
Basic <ProjectId>:<API-Key>
userId*
string
The unique identifier for the user for whom the Auth Code is being requested.
authCode*
string
UUID to initalize SDK valid for 10 minutes
This request permanently deletes all user data associated with a specific user ID. Please note that the data is irreversibly lost.
DELETE
https://sdk.dolph.in/v20/user
Deletes all user data permanently and all of its data
Authorization*
String
Basic <ProjectId>:<API-Key>
userId*
String
Id of Move SDK user
projectId*
String
Id of MOVE SDK project
API for retrieving or modifying user configuration settings.
GET
https://sdk.dolph.in/v20/user/config
fetch the current config for the given user
projectId*
String
Id of MOVE SDK project
userId
String
Id of Move SDK user
Authorization
String
Basic <ProjectId>:<API-Key>
PATCH
https://dolph.in/v20/user/config
update the current config for the given user
userId*
String
Id of Move SDK user
projectId*
String
Id of MOVE SDK project
Authorization*
String
Basic <ProjectId>:<API-Key>
This API enables you to retrieve scores for a specific user, with a focus on Exposure to Risk (ETR) and Move scores. Detailed parameters and responses are provided below
Why It's Important: The more time you spend driving, the greater your exposure to the risk of accidents. This risk is influenced not just by the distance traveled but also by the duration and timing of each trip. For instance, many accidents occur within the first few minutes of a drive, and the risk increases during extended journeys. Avoiding very short trips and taking breaks on longer ones can help mitigate this risk.
How It Works: The ETR Score is calculated based on the number and duration of your trips. Additionally, the type of roads you travel on is factored into the score, with highways being the safest and rural roads posing higher risks. This score helps you understand and manage your exposure to risk, guiding you towards safer driving habits.MOVE Score
Why It's Important: The MOVE Score is your total risk score, offering a clear and comprehensive understanding of your driving safety. It reflects your overall driving habits, combining key factors that influence driving risks.
How It Works: This score merges your MOVE IQ, which evaluates your driving style, with your ETR, which considers how often and how long you drive. By bringing together these aspects, the MOVE Score provides a complete overview of your driving safety, taking into account both the quality of your driving and your time on the road.
GET
https://dolph.in/v20/user/scores
Fetch scores of user, at the moment only ETR and Move score is supported.
userId*
String
Id of Move SDK user
projectId*
String
Id of MOVE SDK project
startTs*
Integer
Start timestamp for the score retrieval.
endTs*
Integer
End timestamp for the score retrieval.
timeframe
String
Timeframe for the score calculation. Available values include DAILY, WEEKLY, MONTHLY, YEARLY, and NONE.
Authorization*
String
Basic <ProjectId>:<API-Key>
This example response includes Exposure to Risk and Move scores along with historical data for various timeframes (daily, weekly, monthly, yearly).
Use this API endpoint to block or unblock a MOVE SDK User. When a user is blocked, the MOVE SDK Backend will return an HTTP Error 403 for all subsequent requests made by the blocked user.
POST
https://sdk.dolph.in/v20/access/block
projectId*
Int
userId*
String
block*
Boolean
An unique device identifier (see Get Device Qualifier / / / ).