{"workspace":{"id":78468,"name":"Telematica","description":null,"slug":"telematica-docs","theme":null,"createdAt":"2022-02-17T13:17:58.197713+00:00","updatedAt":"2022-02-18T11:19:46.368388+00:00","logoUrl":null,"faviconUrl":null,"domain":null,"homeContent":"\n# ⚡️ Telematica EV APIs\n**With Telematica, you can :**\n- Authenticate and connect your customer's EV using a secure end-user-consent flow. \n - ✅ One time secure consent from customer (< 30 sec)\n - ✅ A pure software solution, no need of installing hardwares\n\n- Get live vehicle data from connected EVs to build solutions on top of it\n - ✅ Compatible with Tata and Ather (>70% consumer EVs on road). Support for more OEMs coming soon!\n - ✅ Single standardized API for you, we do the heavylifting behind the scenes\n\n---\n## 🎬 Video Onboarding Walkthrough\n\n[![Walkthrough Video](https://imgur.com/YRVEYVu.gif)](https://player.gotolstoy.com/2ysozsq2xg2a5)\n\n---\n\n## 🔧 Setup (<10 mins)\n\n### 1. **Get your developer keys**\nIn case you don't already have your app-id and secret, reach out to us on [mail](mailto:aditya@telematica.so) to get one issued. You'll need to include these credentials with all API calls made in step 4. If you've requested the keys, you can proceed to step 2. \n\nHere's a sample of how app-id and secret will look like: \n``` json title=\"Sample app-id and secret\" \n{ \n app-id: \"40a67cba-545f-495e-bade-73df342a80cd\",\n secret: \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI0MGE2N2NiYS01NDVmLTQ5NWUtYmFkZS03M2RmMzQyYTgwY2QiLCJpYXQiOjE1MTYyMzkwMjJ9.zyNHt_rNlcN0NlCkvTYHH0RYKaBn9I9lpFeYc85HXA0\"\n}\n```\n
\n\n### 2. **Create a callback POST endpoint in you backend**\nAt the end of user consent flow, Telematica will send vehicle-id of authorized vehicles(s) through a POST request body to your backend. You can store these ids in your database and pair them with users in your app.\n\nThe schema and other details about this POST endpoint can be found in [API reference](https://telematica-docs.stoplight.io/docs/telematica-v2/b3A6NDEwNTExNzI-dummy-callback-endpoint).\n\n\n\n> #### ❗️ Important\n>\n> Please let us know your callback endpoint through [mail](mailto:aditya@telematica.so) after this step. This will allow us to configure our systems accordingly. \n\n
\n\n### 3. **Embed the consent flow in your app**\n\n\n> #### 💡 More about user consent\n>\n> User data is accessible for your app via Telematica's EV APIs only after explicit permission grant by user in form of OEM app credentials. This is a one-time process from user's end, and they are entitled to opt out of data-sharing agreement as per their wish.\n\nEmbed a web-view in your mobile app, pointing at the following URL: \n\n`https://connect-ui.vercel.app/connect?app=&user=`\n\n
\n\n### 4. **Access vehicle data through our Vehicle APIs**\nOnce the user has granted consent for your app to access their vehicle data, you can use [Vehicle Data APIs](https://telematica-docs.stoplight.io/docs/telematica-v2/b3A6NDEwNTExNzM-soc-battery-level) to fetch vehicle data from your backend. \n\n\n---\n\n\n## 💬 FAQs\n\n**Can I secure my POST endpoint with a bearer token?**\n\nYes, please make sure you communicate the details over [email](mailto:aditya@telematica.so) if you choose to.\n\n
\n\n**Can we skip the brand selection screen in consent flow?**\n\nYes, just add a query parameter to the consent UI url as shown below:\n\n`https://connect-ui.vercel.app/connect?app=&user=&brand=Tata`\n\nNote : We support `Tata` and `Ather` brands as of now, with support for new brands coming soon.\n\n---\n\n## 🙋‍♂️ We're Here to Help\n\nGet in touch and let us know how we can help.\n\n\n\nShoot an email at [aditya@telematica.so](mailto:aditya@telematica.so), we'll get back to you asap.\n\n\n\nDrop a message or call directly on [+919406862615](https://wa.me/+919406862615)\n\n\n","hidePoweredBy":false,"localizejs":null,"hideSignIn":false,"googleTagManager":null,"redirects":null,"creatorId":130802,"migratedFromNext":false,"teamsEnabled":false,"features":[{"id":533132,"maxQuantity":30,"feature":{"id":1,"name":"changelogs","type":"limit","__typename":"sl_features"},"__typename":"sl_workspace_features"},{"id":533135,"maxQuantity":3,"feature":{"id":3,"name":"members","type":"limit","__typename":"sl_features"},"__typename":"sl_workspace_features"},{"id":533133,"maxQuantity":1000,"feature":{"id":4,"name":"hosted_mocking","type":"limit","__typename":"sl_features"},"__typename":"sl_workspace_features"},{"id":533134,"maxQuantity":2,"feature":{"id":5,"name":"projects","type":"limit","__typename":"sl_features"},"__typename":"sl_workspace_features"}],"integrations":[{"id":292473,"name":"Bitbucket Cloud","enabled":true,"config":{},"allowUserLogin":true,"allowUserRegister":true,"integration":{"id":9,"kind":"bitbucket_cloud","shortcode":"bbc","name":"Bitbucket Cloud","config":{"apiUrl":"https://api.bitbucket.org/2.0","hostUrl":"https://bitbucket.org","clientId":"FJt5Jb9DwW8K4YWGfE","redirectUrl":"https://stoplight.io:443/oauth/callback"},"__typename":"sl_integrations"},"__typename":"sl_workspace_integrations"},{"id":292470,"name":"Email","enabled":true,"config":{},"allowUserLogin":true,"allowUserRegister":true,"integration":{"id":1,"kind":"builtin","shortcode":"sl","name":"Email","config":{},"__typename":"sl_integrations"},"__typename":"sl_workspace_integrations"},{"id":292471,"name":"GitHub","enabled":true,"config":{},"allowUserLogin":true,"allowUserRegister":true,"integration":{"id":2,"kind":"github","shortcode":"gh","name":"GitHub","config":{"apiUrl":"https://api.github.com","hostUrl":"https://github.com","clientId":"14b4eb468fc1419a5290","redirectUrl":"https://stoplight.io:443/oauth/callback"},"__typename":"sl_integrations"},"__typename":"sl_workspace_integrations"},{"id":292472,"name":"GitLab","enabled":true,"config":{},"allowUserLogin":true,"allowUserRegister":true,"integration":{"id":3,"kind":"gitlab","shortcode":"gl","name":"GitLab","config":{"apiUrl":"https://gitlab.com/api/v4","hostUrl":"https://gitlab.com","clientId":"ac92ea2ad339f25ae1f3264c2d851c8eb23f84e8ea5ec297d3504dc735488238","redirectUrl":"https://stoplight.io:443/oauth/callback"},"__typename":"sl_integrations"},"__typename":"sl_workspace_integrations"}],"disableDefaultStyleguideEditing":false,"__typename":"sl_workspaces"}}