Creating the POST callback endpoint
1. Expose a POST endpoint in your backend
Expose a POST endpoint (preferable ending with /telematica-callback
) in your backend, which will receive callbacks. It is advised to add a bearer token as security for this endpoint.
2. Configure your backend
Configure your backend to save user-to-device mapping in your database and other webhook events when a POST call comes in from Telematica on the above endpoint.
You can expect the POST request body to follow the schema mentioned here.
3. Share the endpoint with Telematica
Share the endpoints you've created with us over Email.
Also share the authentication token for endpoint if you have any.
FAQs
Why is there a callback endpoint?
Once the end user logs in with their OEM credentials, we make a callback to your backend to pass on the information to your backend.
The information shared includes deviceId
in our database and userId
in your database to map it to.
Can I add an authentication token to the POST endpoint?
Sure. Please make sure your backend accepts the token in following header format:
--header 'Authorization: Bearer QOkDgC532UGa9pK3L0a'
Can I make different endpoints for different environments (dev
, stage
, prod
) ?
dev
, stage
, prod
) ?Yes. Telematica will hit the prod
endpoint by default if no special query parameter is present.
To indicate Telematica to make callback on any other endpoint, please add a callbackUrl
parameter in the consent UI
Updated 2 months ago