# Documentation 👋

Here, we explain how to use ROOTE's services.

## WAT API ?

An API (Application Programming Interface) is a server that enables information to be distributed instantaneously between two machines. APIs are being used more and more in programming, as they allow great flexibility and, above all, real-time updating of data. 

It's as if you were calling on an intelligence brick from someone who has already taken the time to create this algorithm, rather than re-coding it entirely in your project.

{% hint style="info" %}
When two machines "talk" to each other, the result nomenclature enables instantaneous interpretation by the machines. **JSON** format is used in the case of a classic API, so it's important to structure your data properly. 😌
{% endhint %}

## What are the benefits of an API ?

```
Flexibility 
Responsiveness
Safety
```

1. The API makes it very easy to get started and integrate into your projects almost immediately. You can re-use its data for any kind of service, be it a website, a mobile application or even a conversational assistant!
2. The API enables you to get a response in real time. You're instantly fixed on the result, the calculation of the result takes place at the server level, and you receive only the essentials!
3. APIs feature secure authentication: if you don't have a token, you won't be able to access the data.

## Who are APIs for ?

There are no prerequisites for using an API, only the logical meaning.

{% hint style="warning" %}
You specify the search criteria in the parameters. This is "the call" or the request. 

Ex: developers.roote.io/api/realtime/48.8701975,2.3375063/weather
{% endhint %}

{% hint style="success" %}
You instantly receive the information in the JSON response. 

Ex : "weather": { "temp": 18.28, "description": "clear sky" }
{% endhint %}

Whether you're an IT expert or just curious, APIs are tomorrow's digital gold. In this new, ultra-connected world where the Smart City is booming, you're bound to come across APIs sooner or later.

{% embed url="<https://medium.com/roote/les-apis-%EF%B8%8F-lor-numerique-358290793b31>" %}
🇫🇷 Learn more about APIs and tomorrow's uses 👆
{% endembed %}

![](https://4280107080-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWcpc200vmiMyVBkIxP%2F-LfncokJ3Sf6YZkGBul9%2F-LfngsBiV1hibdvLIZPf%2FROOTE_.png?alt=media\&token=980aea08-a2e1-4c4d-8611-dcc924e0df9d)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roote.ai/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.