Authentification 🔐

Il vous faut obtenir un token avant de pouvoir interroger notre API.

1) Inscription au service

Il est nécéssaire de s'inscrire sur le site developers.roote.io pour utiliser la liste des services présents dans cette documentation.

Une fois sur la fenêtre de login, remplissez le formulaire de gauche pour créer un compte.

2) Vérifiez votre mail

Après la validation du formulaire, un mail de vérification est envoyé sur votre boite mail.

Il est nécéssaire de valider votre adresse avant de pouvoir vous connecter sur l'interface.

Pour valider votre adresse, cliquez simplement sur le lien reçu dans le mail.

Vous pouvez maintenant vous connectez au site developers.roote.io

3) Générez un token

Sur la page "Compte", un bouton bleu vous permettra de générer un token.

"Regénérer le token" supprime le token actif, il faudra alors le remplacer dans vos bases.

get
Utilisation du token dans les requêtes

https://developers.roote.io/api/realtime/:coords/:service?token=:token
Remplacer le paramètre :token par le token actif du compte developers.roote.io
Request
Response
Path Parameters
:coords
required
string
Latitude,Longitude de votre position. 44.83301,-0.570184
:service
required
string
Un service parmi REALTIME
Query Parameters
:token
required
string
Token actif du compte developers.roote.io
200: OK
Votre token fonctionne et vous obtenez un résultat comme celui-ci.
[
{
"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: Bad Request
Votre token n'est pas bon.
Unauthorized: Invalid token