Preventive maintenance scheduling

​

Prerequisites: Creating Your Application

Before implementing preventive maintenance capabilities ensure you have:

• Created a Smartcar account and registered your application to obtain your client_id and client_secret.
• Set up the Smartcar Connect flow to authenticate and authorize users.

​

Smartcar API Endpoints for Preventive Maintenance

Use the following endpoints to build your preventive maintenance solution:

​

1. Track Odometer Readings

Retrieve odometer data to schedule maintenance services such as tire rotations or oil changes based on mileage.

curl "https://api.smartcar.com/v2.0/vehicles/{id}/odometer" \
    -H "Authorization: Bearer {token}" \
    -X "GET"

    {
        "distance": 104.32
    }

Use Case Send a notification when a vehicle’s odometer reading reaches maintenance intervals, such as every 5,000 miles.

​

2. Monitor Engine Oil Life

Retrieve oil life data to prompt users when an oil change is due.

curl "https://api.smartcar.com/v2.0/vehicles/{id}/engine/oil" \
    -H "Authorization: Bearer {token}" \
    -X "GET"

{
  "lifeRemaining": 0.35
}

Use Case Trigger a service reminder when oil life falls below 20% to prevent engine damage.

​

3. Retrieve Diagnostic Trouble Codes (DTCs)

DTCs help you identify and diagnose specific vehicle issues, allowing for quick and accurate repairs.

curl "https://api.smartcar.com/v2.0/vehicles/{vehicleId}/diagnostics/dtcs" \
    -H "Authorization: Bearer {token}" \
    -X "GET"

{
    "activeCodes": [
      {
        "code": "P302D",
        "timestamp": "2024-09-05T14:48:00.000Z"
      }
    ]
}

Use Case Notify a driver immediately if a new trouble code is detected, enabling faster response times.

​

4. Monitor Vehicle System Status

Retrieve a snapshot of key systems like the engine and battery to assess health and detect anomalies.

curl "https://api.smartcar.com/v2.0/vehicles/{vehicleId}/system-status" \
    -H "Authorization: Bearer {token}" \
    -X "GET"

{
      "systems": [
          {
              "systemId": "SYSTEM_TPMS",
              "status": "ALERT",
              "description": "Left rear tire sensor battery low"
          },
          {
              "systemId": "SYSTEM_AIRBAG",
              "status": "OK",
              "description": null
          },
          {
              "systemId": "SYSTEM_MIL",
              "status": "OK",
              "description": null
          },
      ]
}

Use Case Notify users or fleet operators if the engine status changes to warning or the battery health declines.

​

Webhooks for Preventive Maintenance

Webhooks enable real-time notifications for certain vehicle events, reducing the need for polling. Examples include:

• DTC Updates: Receive a webhook when a new trouble code is logged.
• System Changes: Get updates for changes in engine or battery status.

​

Setting Up Webhooks

To receive real-time notifications (e.g., when new DTCs appear), consider setting up webhooks:

1. Create a Webhook: Configure a secure endpoint on your server to handle POST requests from Smartcar.
2. Register the Webhook: Specify which events (such as DTC) you want to subscribe to.
3. Instant Alerts: When an event triggers, Smartcar sends a payload to your endpoint, enabling immediate responses (like sending notifications or scheduling service).

​

Example Workflow

1. Authorization: The user logs in via Smartcar Connect to grant access to vehicle data.
2. Monitoring: Your backend polls GET endpoints (e.g., odometer, oil, system status) or listens for webhook events.
3. Threshold Detection: Evaluate data (e.g., oil life < 20%, mileage > 5,000 miles) and identify DTCs or system warnings.
4. Notifications: Send push notifications, emails, or SMS to users with maintenance reminders or alerts.
5. Ongoing Updates: Combine periodic polling and webhooks to ensure vehicles stay road-ready.

​

FAQs