> For the complete documentation index, see [llms.txt](https://docs.g-iot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.g-iot.io/fr/gestion-des-donnees-and-conformite-au-data-act-de-lue/telecharger-les-donnees-via-api.md).

# Télécharger les données via API

La plateforme GIoT permet l’export sécurisé des données via API afin de se conformer au **Data Act de l’UE**.\
Cette méthode vous permet de récupérer toutes les données de vos dispositifs de manière programmatique, dans un format structuré, facilitant l’intégration avec des systèmes tiers ou la migration vers d’autres plateformes.\
Suivez les étapes ci-dessous pour générer votre **jeton API** et accéder à vos données en toute sécurité.

{% hint style="danger" %}
Seuls les utilisateurs disposant des privilèges de Super Admin ou d’autorisations explicites peuvent accéder à cette section.
{% endhint %}

<figure><img src="/files/7JDm3f1pNYgm9TmPaet5" alt=""><figcaption></figcaption></figure>

***

#### Étapes pour exporter les données via API

1. **Accéder à la documentation API :**
   * Depuis le menu Cockpit, naviguez vers **Administration** et cliquez sur **API**.
   * Un nouvel onglet de navigateur s’ouvrira directement sur **Swagger**, affichant la documentation publique de l’API GIoT.
2. **Localiser le point de terminaison API pertinent :**
   * Parcourez les sections API organisées pour trouver les endpoints d’export des données.
   * Exemples :
     * **Devices** → Exporter les listes de dispositifs et leurs configurations.
     * **Rules** → Récupérer les règles et seuils configurés.
     * **Alarms** → Télécharger l’historique complet des alarmes.
     * **Measurements** → Exporter les données de mesure collectées.
3. **Sélectionner la méthode API :**
   * Cliquez sur l’endpoint souhaité et choisissez la méthode **GET** ou **POST**, selon les données à exporter.
4. **Insérer les paramètres requis :**
   * Si l’endpoint nécessite des paramètres (par exemple, ID du Tenant, ID du Device, ou plage de dates), remplissez les champs correspondants.
5. **Exécuter la requête :**
   * Cliquez sur **Try it out** pour exécuter la requête API directement dans Swagger.
   * Les données s’afficheront dans la section **Response Body** en dessous.
6. **Télécharger ou sauvegarder les données :**
   * Copiez les données renvoyées ou téléchargez-les au format **JSON**.
   * Vous pouvez ensuite les convertir en CSV ou dans d’autres formats si nécessaire.

{% hint style="warning" %}
Les endpoints API sont regroupés par fonction et incluent des descriptions détaillées pour vous guider. Cela vous permet d’exporter toutes les informations pertinentes — dispositifs, alarmes, mesures, etc. — directement depuis la plateforme, conformément aux exigences du **Data Act de l’UE**.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.g-iot.io/fr/gestion-des-donnees-and-conformite-au-data-act-de-lue/telecharger-les-donnees-via-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.