Bonjour 👋

Bienvenue dans la documentation de l'API de ROOTE. ⚡️

Qu'est-ce qu'une API ?

Une API (Application Programming Interface) est un serveur permettant de distribuer des informations instantanément entre deux machines. Les API sont de plus en plus utilisées dans la programmation car elles permettent une grande flexibilité et surtout une actualisation en temps réel des données. C'est comme si vous faisiez appel à une brique d'intelligence chez quelqu'un qui à déjà pris le temps de réaliser cet algorithme plutôt que de le re-coder entièrement dans votre projet.

Quand deux machines "discutent" entres-elles, la nomenclature du résultat permet une interprétation instantanée par les machines. On utilise le format JSON dans le cas d'une API classique, il est donc important de bien structurer ses données. 😌

Quel sont les avantages d'une API ?

Flexibilité
Réactivité
Sécurité

1) L'API va permettre une prise en main très simple et une intégration quasi-immédiate dans vos projets. Vous pouvez ré-utiliser ses données pour n'importe quel service, aussi bien pour un site web qu'une application mobile ou même un assistant conversationnel ! 2) L'API permet d'obtenir une réponse en temps réel. Vous êtes instantanément fixé sur le résultat, le calcul du résultat se passe au niveau du serveur et vous recevez uniquement l'essentiel ! 3) Les API disposent d'une Authentification sécurisée, si vous ne possédez pas de token, vous ne pourrez pas accéder aux données.

A qui s'adresse les API ?

Il n'y a pas de pré-requis pour utiliser une API, seul le sens logique s'applique.

Vous indiquez en paramètres les critères de recherche. C'est "le call" ou la demande.

Ex : developers.roote.io/api/realtime/48.8701975,2.3375063/weather

Vous recevez les instantanément les informations dans la réponse en JSON.

Ex : "weather": { "temp": 18.28, "description": "ciel dégagé" }

Que vous soyez expert en informatique ou simple curieux, les API sont l'or numérique de demain. Dans ce nouveau monde ultra connecté où la Smart City est en pleine expansion, vous serez certainement amené un jour ou l'autre à parler d'API.