Auth 🔐

You need to obtain a token before you can query our API.

1) Service registration

You need to register on developers.roote.io to use the list of services in this documentation.

Once on the login window, fill in the form on the left to create an account.

2) Check your e-mail

After validating the form, a verification e-mail is sent to your mailbox.

It is necessary to validate your address before you can connect to the interface.

To validate your address, simply click on the link in the e-mail.

You can now connect to devs.roote.ai

3) Create token

On the "Account" page, a blue button allows you to generate a token.

"Regenerate token" deletes the active token, so you'll need to replace it in your databases.

Using the token in queries

GET https://devs.roote.ai/api/realtime/:coords/:service?token=:token

Replace the :token parameter with the active token of the developers.roote.io account

Path Parameters

Name	Type	Description
:coords*	string	Latitude,Longitude of location 44.83301,-0.570184
:service*	string	REALTIME MODE

Query Parameters

Name	Type	Description
:token*	string	Active account token api.roote.ai

200 Success call

[
    {
    "id": 625,
    "name": "Lionel",
    "lat": 44.834918,
    "lng": -0.568368,
    "battery": 88,
    "distance": 256
    },
    {
    "id": 693,
    "name": "Laurence",
    "lat": 44.835482,
    "lng": -0.568165,
    "battery": 86,
    "distance": 318
    }
]

400 Fail call

Unauthorized: Invalid token