LogoLogo
DocsHomeSupportContact
  • Getting Started
    • Introduction
    • Build on DIMO
  • DEVELOPER GUIDE
    • Developer Overview
    • Developer Console
    • Authentication
    • DIMO Developer SDKs
      • Data SDK
      • Login with DIMO SDK
        • React Component
        • Login with DIMO Redirect
        • Core Functionalities
      • TypeScript: Transactions SDK
      • SDK Release Notes
    • Low Code Tools
      • n8n: Getting Started
    • Permissions Contract: SACD
    • DIMO Credits
    • Response Types
    • Rate Limits
    • Developer FAQ
    • Developer Changelogs
    • Troubleshooting Common Issues
  • API References
    • Overview of DIMO API
    • Attestation API
    • Device Definitions API
    • Identity API
      • Schema & Types
      • Scalars
      • Nodes & Objects
        • AftermarketDevice
        • AftermarketDeviceConnection
        • DCN
        • DCNConnection
        • DeveloperLicense
        • DeviceDefinition
        • Earning
        • EarningsConnection
        • Manufacturer
        • Sacd
        • SyntheticDevice
        • Vehicle
        • VehicleConnection
        • VehicleEarnings
        • UserRewards
      • Common Queries
    • Telemetry API
      • Schema & Types
      • Scalars
      • Nodes & Objects
        • Signals
        • SignalsLatest
      • Common Queries
    • Token Exchange API
    • Trips API
    • Valuations API
  • DIMO Hardware
    • Introduction
    • DIMO Hardware Application
    • DIMO Manufacturing License
    • Development & Certification
    • Audits & Assessments
      • Hardware & Security Audit
      • Customer Experience Assessment
      • Integration Testing & Quality Control
      • Final Approval
    • DIMO Device License
      • Device Minting Certificates
    • Essential Documents
      • Hardware & Security Audit Checklist
      • Approved Hardware Auditors
      • DIMO Memorandum of Understanding (MOU)
  • Additional References
    • Developer License
    • DIMO GraphQL Basics
  • Deprecated Resources
    • Guides
      • Developer Journey
      • Quick Start Guide
      • Hello World
      • Code Exchange Flow
    • Data Availability
Powered by GitBook
On this page
  • Getting Started as a Software Dev
  • Authentication
  • Onboarding
  • Getting Started as a DIMO Hardware Dev

Was this helpful?

  1. Deprecated Resources
  2. Guides

Quick Start Guide

PreviousDeveloper JourneyNextHello World

Last updated 7 months ago

Was this helpful?

Getting Started as a Software Dev

DIMO Check-in

DIMO fullstack dev refers to developers that utilize the entire stack of the DIMO protocol, from vehicle creation to onboarding users to providing services. A typical DIMO fullstack would be the DIMO Mobile App.

If you are looking to get access to vehicles that are already connected to the network or prefer using the DIMO mobile app to onboard your customers, please refer to the quick guide in Data Devs instead.

To start exploring in the DIMO Network, the is your best bet. This GraphQL API contains publicly-available data for every single connected vehicles in the DIMO Network. These public data are stored onto the blockchain and readily available via the GraphQL layer that DIMO has built.

You can simply build stuff using this publicly available API or offer more detailed vehicle data by going through the next set of steps.


Authentication

User Authentication


API Authentication


The following onboarding section is about to be deprecated in Q4 2024. Please refrain from implementing it into your workflow.

Onboarding

User Initiation & Creation

DIMO Check-in

There are two routes of user creation, depending on whether you've implemented User Login redirect or API authentication with your application.

Vehicle Onboarding


Getting Started as a DIMO Hardware Dev

DIMO Check-in

(Optional) To implement a user login flow, developers can simply surface a (aka Code Exchange Flow) that redirects the user to with your set of client_id, redirect_uri, and other URL parameters.

(Optional) In cases where you wish to handle your own user login and not use the Login with DIMO redirect, you should learn how to build a into your application.

After you finish interacting with the auth server, you will have gained an access_token. Regardless of the authenticated method, you should use the access_token to hit first. The response will tell you what you should be doing next - either attaching a wallet or confirming an email.

For users created using the Web2 OAuth (Apple or Google SSO), developers will need to attach a Web3 0x wallet address to the user created. To do so, you will need to call and update the user appropriately.

When using the API authentication method, you will need to provide your end users a way to connect their Web3 0x wallet (e.g. WalletConnect integration) and use the wallet to perform the steps in the . Once authentication completes, your application should perform these set of actions:

to initiate a 2FA verification email.

to conclude the 2FA confirmation.

DIMO hardware dev refers to developers that are either looking to design & manufacture a device from scratch or integrate an existing device to work on the DIMO Network. A typical hardware dev would be developing something like an AutoPi, Macaron, or LTE R1 that you see in the .

If you are a hardware developer, follow our to get a general understanding of the hardware development process. You can pretty much ignore the API references and resources.

Login to DIMO
https://auth.dimo.zone/auth
wallet-based authentication flow
wallet-based authentication flow
⚙️
DIMO store
hardware onboarding flow
✨
🗣️
#vehicle-creation
#updating-vehicle-vin
#claiming-an-aftermarket-device
#minting-a-vehicle
#pairing-a-vehicle-with-aftermarket-device
A visualization on the different types of auth: Wallet-based or Code Exchange
Get Authenticated User
Update Authenticated User
Send a Confirmation Email
Submit an Email Confirmation Key