Skip to main content

How to Integrate a Vehicle QR Code

QR codes enable users to start a ride with the spotted Dott vehicle.

How does it work:

  1. A user scans a QR code on a Dott vehicle.
  2. You decode the QR code. Its value contains a https://v.ridedott.com/{pathname} URI. The pathname is a unique vehicle identifier consisting of 6 alphanumeric characters.
  3. You make a call to the SearchVehicle API in the Vehicles service. It requires the uri query parameter which is the URI obtained in the previous step. The API returns the Vehicle resource or an error in case of an invalid request.
  4. You retrieve the vehicleId from the Vehicle name property. Its value has the following format: vehicles/{vehicleId}. The second segment is the 20-character vehicleId that is required for starting a trip.