Smartcar is an API that allows mobile and web applications to communicate with vehicles across brands (think “check odometer” or “unlock doors.”). This tutorial will help you get up and running with the Smartcar API.
In this tutorial, we will use the Ruby SDK and Sinatra to create a simple server-side rendered web application that displays your car’s information.
How Smartcar works with server-side rendered applications
- The Application redirects the user to Smartcar Connect to request access to the user’s vehicle. In Connect, the user logs in with their vehicle credentials and grants the Application access to their vehicle.
- The user’s browser is redirected to a specified
redirect_uri. The Application Server, which is listening at the
redirect_uri, will retrieve the authorization
codefrom query parameters sent to the
- The Application sends a request to the Smartcar API. This request contains the authorization
codealong with the Application’s client id and client secret.
- In response, Smartcar returns an
- Using the
access_token, the Application can now send requests to the Smartcar API. It can access protected resources and send commands from and to the user’s vehicle, such as retrieve the location and unlock the doors.
How this tutorial is structured
Follow along with our integration tutorial to build our simple web application.
This tutorial is split into three sections:
- Setup - Set up your environment to develop on Smartcar
- Authorization flow - Learn about Smartcar Connect and how to get an authorization code
- Send a request - Learn how to exchange an authorization
access_tokenrequired to send a request to Smartcar
Let’s get building!