In this guide you will go through the required steps to integrate BotOn in your own systems or platforms.
1.- Creating an account
In order to start using our APIs, you will need to create an account. Once you have registered, come back to this page to continue.
BotOn has offers you two main methods for authenticating:
- your current user (using your email and password), or
- an API token created for your organization.
With email and password
By default, BotOn allows you to authenticate your user using the email and password that you have used to register in the site.
You can login using the endpoint:
With a payload like this:
You will get a JWT token that you will have to use within your API calls to authenticate:
With an API token
If you want to avoid using your own credentials, you can create a token that will identify the organization instead of you.
For creating the token, use the following endpoint:
This will return an API key that you can use to authenticate your API calls using the following HEADER in your calls:
You cannot recover the key. If you don't save it the system cannot show it to you as is fully encrypted. You will need to generate a new key, and replace it.
2.- Registering your first tracker
Once you have an account, you will need to register a tracker so you can start getting geo-data that BotOn will process and give you insights.
A tracker is a device that is connected to a vehicle (or moving object) that will be sending at least the following information:
- longitude and
In order to register it, you will need to find out the default group (organization is named right now but will be changed into group in coming weeks) that your account has access to.
There you will have the OIDs and extra data of the groups where you can register a tracker to. Pick one, and save the OID for using it later on.
Now, register the tracker:
You will have to send a JSON payload similar to this:
1 2 3 4 5 6 7 8 9 10 11 12 13
The object_id can store any metadata from your vehicle. By default, we recognize some keys like license_plate, make, model, version, vin, ean, serial_number as those are common fields within the cars, vans, bikes, kickscooters and trucks. But you can store as much information as you want.
3.- Getting telemetrics data from your tracker
Now that you have the tracker, as soon as the tracker is validated by the system, you will be able to start getting telemetrics data from it like its last position. In order to check if the tracker is receiving data properly, get the tracker and check its status value. If its value is true, then, your tracker is fully working within BotOn:
And it will return something like this:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
Then, with that tracker's oid you can get its last saved position:
And that will give you something similar to this:
1 2 3 4 5
4.- Next steps
This guide has covered the main basics, for setting you up quickly. Now we recommend you to explore our documentation and get an idea about what BotOn can offer you. We recommend you to read the following sections of our documentation: