RoscoLive API v1.0
  1. Driver Scoring / Coaching
RoscoLive API v1.0
  • Device
    • Get device list for multiple companies
      GET
    • Get current activity status of devices
      GET
  • Driver Scoring / Coaching
    • Get company event score weights
      GET
    • Update company event score weights
      POST
  • Event
    • Get company events
      GET
    • Request videos of an event
      PUT
    • Get events for a device
      GET
  • Fleet Configuration
    • Create new profile in a company
      POST
    • Get a company profile
      GET
  • Metadata
    • Get alerts and events of devices for company
      GET
  • Report
    • Get custom report data
      GET
    • Get all events report for company
      GET
    • Get event count summary report for company devices
      GET
    • Update custom report
      POST
    • Create custom report for user
      PUT
  • User
    • Get a user
      GET
    • Get own info
      GET
    • Get application notifications
      GET
    • SD card reformat reminder
      POST
    • Update notification by email
      POST
    • Get event / sms notification settings
      GET
  1. Driver Scoring / Coaching

Update company event score weights

POST
https://fleet.roscolive.com/api/v1.0/driver/scoring/weights
driver
Update event score weights for driver scoring in a company. Driver score weights are on a scale of 1 to 5 with 1 being the least impactful.
Roles with endpoint access
RolePermission
Partner
Partner View
Custom Partner
Fleet Manager
Group Manager
User
Custom User
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://fleet.roscolive.com/api/v1.0/driver/scoring/weights' \
--form 'company_id="{{$number.int(min=0,max=9999)}}"' \
--form 'weights="{
  \"idling\": {
    \"weight\": 2,
    \"enabled\": true
  },
  \"adas_fcw\": {
    \"weight\": 3,
    \"enabled\": true
  },
  \"adas_pcw\": {
    \"weight\": 3,
    \"enabled\": true
  },
  \"adas_ldw\": {
    \"weight\": 3,
    \"enabled\": true
  },
  \"gsensor\": {
    \"weight\": 3,
    \"enabled\": true
  },
  \"distraction\": {
    \"weight\": 5,
    \"enabled\": true
  },
  \"drowsiness\": {
    \"weight\": 4,
    \"enabled\": true
  },
  \"yawning\": {
    \"weight\": 3,
    \"enabled\": true
  },
  \"phone_use\": {
    \"weight\": 4,
    \"enabled\": true
  },
  \"harshaccel\": {
    \"weight\": 3,
    \"enabled\": true
  },
  \"harshbraking\": {
    \"weight\": 2,
    \"enabled\": true
  },
  \"low_speeding\": {
    \"weight\": 1,
    \"enabled\": true
  },
  \"moderate_speeding\": {
    \"weight\": 2,
    \"enabled\": true
  },
  \"high_speeding\": {
    \"weight\": 4,
    \"enabled\": true
  },
  \"severe_speeding\": {
    \"weight\": 5,
    \"enabled\": true
  },
  \"max_speed\": {
    \"weight\": 5,
    \"enabled\": true
  },
  \"seatbelt\": {
    \"weight\": 4,
    \"enabled\": true
  },
  \"smoking\": {
    \"enabled\": false,
    \"weight\": 5
  },
  \"camera_block\": {
    \"weight\": 2,
    \"enabled\": true
  }
}"'
Response Response Example
200 - Success
{
    "meta": {
        "code": 200
    },
    "response": "success",
    "result": "OK"
}

Request

Body Params multipart/form-data
company_id
integer 
optional
ID of company. Required only for partner user roles
Example:
{{$number.int(min=0,max=9999)}}
weights
string <json>
required
Stringified JSON object containing the updates to the desired fields. Only fields passed will have their values updated.
Example:
{ "idling": { "weight": 2, "enabled": true }, "adas_fcw": { "weight": 3, "enabled": true }, "adas_pcw": { "weight": 3, "enabled": true }, "adas_ldw": { "weight": 3, "enabled": true }, "gsensor": { "weight": 3, "enabled": true }, "distraction": { "weight": 5, "enabled": true }, "drowsiness": { "weight": 4, "enabled": true }, "yawning": { "weight": 3, "enabled": true }, "phone_use": { "weight": 4, "enabled": true }, "harshaccel": { "weight": 3, "enabled": true }, "harshbraking": { "weight": 2, "enabled": true }, "low_speeding": { "weight": 1, "enabled": true }, "moderate_speeding": { "weight": 2, "enabled": true }, "high_speeding": { "weight": 4, "enabled": true }, "severe_speeding": { "weight": 5, "enabled": true }, "max_speed": { "weight": 5, "enabled": true }, "seatbelt": { "weight": 4, "enabled": true }, "smoking": { "enabled": false, "weight": 5 }, "camera_block": { "weight": 2, "enabled": true } }

Responses

🟢200Success
application/json
Body
meta
object 
required
Request metadata object
code
integer 
required
HTTP status code returned by response
response
string 
required
Contains response data
result
string 
required
"OK" if successful, else "Fail" if error
🔴500Internal Server Error
🟠404Resource Not Found
🟠401Login Required
Modified at 2024-11-26 18:46:51
Previous
Get company event score weights
Next
Get company events
Built with