*Leaderboard by factors

Users leaderboard by scoring factors and driving statistics. the leaderboard is calculated based on previous 14 days driving data.

Leaderboard

GET https://leaderboard.telematicssdk.com/v1/Leaderboard

This endpoint allows you to get a list of users with ranks Authorization: Allow Anonymous

Query Parameters

Name	Type	Description
UsersCount	integer	Number of TOP-X users. If you want to show TOP-5 users - UserCount = 5.
RoundUsersCount	integer	Number of users around the requested user position.
ScoringRate	integer	1 - Acceleration score 2 - Braking Score 3 - Phone Usage Score 4 - Speeding Score 5 - Cornering Score 6 - Overall Score 7 - Distance 8 - Number of Trips 9 Driving Time

Headers

Name	Type	Description
DeviceToken	string	User deviceToken

200 Cake successfully retrieved.

{
  "Result": {
    "UsersNumber": 61, // Total number of users in respose
    "ScoringRate": "Acceleration", // Selected factor
    "Users": [
      {
        "DeviceToken": "", // User device token
        "Nickname": null, //Nickname
        "FirstName": null,
        "LastName": null,
        "Image": "", // avatar image URL
        "Value": 100, // Factor value
        "Place": 1, // rank
        "IsCurrentUser": false //if requested user = true
      },
      {
        "DeviceToken": "",
        "Nickname": null,
        "FirstName": null,
        "LastName": null,
        "Image": "",
        "Value": 100,
        "Place": 2,
        "IsCurrentUser": false
       }
    ]
  },
  "Status": 200,
  "Title": "",
  "Errors": []
}

in case when a requested user is in a number of UsersCount, the response will contain only Users Count, otherwise it will be combined list UsersCount + RoundUserCount + requested user.

The leaderboard contains ranking information based on the last 14 days driving data.