Plan your integration
Make requests to Smartcar
There are two ways in which requests to the Smartcar API can be triggered:
User-triggered: Your application makes a request to Smartcar based on a user-initiated action (e.g. pressing a button in a mobile application).
a. We recommend having a loading state for user-triggered requests in order to give users a visual cue that their request is being sent.
b. Your application should expect a maximum response latency of 300 seconds. On average, requests should take between three and 45 seconds.
Application-triggered: Your application sends requests on a scheduled basis to retrieve vehicle data (e.g. retrieving an odometer reading at the end of every month).
a. We recommend that you spread out the request load over time. As a rule of thumb, you should make less than 10 requests per minute to Smartcar. In addition, you should make less than 20 requests per vehicle per hour.b. To learn more about your application’s rate limits, please contact our support team.
const batch = await vehicle.batch(["/odometer", "/location"]);