---
title: Export de données & API (CSV and API)
description: Découvrez la signification de chaque métrique dans votre export de données. Référence complète pour les métriques CSV et API — couvrant la puissance, l'énergie, la tension, le courant et plus encore.
---

[Passer au contenu](https://support.sensorfact.eu/fr/knowledge/export-de-données-api-csv-and-api#main-content)

- [Français](https://support.sensorfact.eu/fr/knowledge/export-de-donn%C3%A9es-api-csv-and-api)
- [Deutsch](https://support.sensorfact.eu/de/knowledge/datenexport-api)
- [English](https://support.sensorfact.eu/knowledge/what-metrics-are-returned-by-the-data-export-and-api)
- [Español](https://support.sensorfact.eu/es/knowledge/exportación-de-datos-api)
- [Italiano](https://support.sensorfact.eu/it/knowledge/esportazione-dati-api-csv-and-api)
- [Nederlands](https://support.sensorfact.eu/nl/knowledge/data-export-api)
- [Polski](https://support.sensorfact.eu/pl/knowledge/eksport-danych-api)

Français

Afficher le sous-menu pour les traductions

![light-4.svg\]](https://support.sensorfact.eu/hubfs/light-4.svg)

Ouvrir la navigation principale

Fermer la navigation principale

- - [Français](https://support.sensorfact.eu/fr/knowledge/export-de-donn%C3%A9es-api-csv-and-api)
    - [Deutsch](https://support.sensorfact.eu/de/knowledge/datenexport-api)
    - [English](https://support.sensorfact.eu/knowledge/what-metrics-are-returned-by-the-data-export-and-api)
    - [Español](https://support.sensorfact.eu/es/knowledge/exportación-de-datos-api)
    - [Italiano](https://support.sensorfact.eu/it/knowledge/esportazione-dati-api-csv-and-api)
    - [Nederlands](https://support.sensorfact.eu/nl/knowledge/data-export-api)
    - [Polski](https://support.sensorfact.eu/pl/knowledge/eksport-danych-api)

  Français
  
  Afficher le sous-menu pour les traductions
- [Accéder au Guide des bonnes pratiques](https://support.sensorfact.eu/resource-hub)

[Accéder au Guide des bonnes pratiques](https://support.sensorfact.eu/resource-hub?hsLang=fr)

 Que cherchez-vous ?

- Il n'y a aucune suggestion car le champ de recherche est vide.

1. [Base de connaissances](https://support.sensorfact.eu/fr/knowledge?hsLang=fr)
2. [Tableau de bord & Analyses](https://support.sensorfact.eu/fr/knowledge/tableau-de-bord-analyses?hsLang=fr)
3. [Électricité](https://support.sensorfact.eu/fr/knowledge/tableau-de-bord-analyses?hsLang=fr#%C3%A9lectricit%C3%A9)

# Export de données & API (CSV and API)

## Découvrez la signification de chaque métrique dans votre export de données. Référence complète pour les métriques CSV et API — couvrant la puissance, l'énergie, la tension, le courant et plus encore.

#### Résolution

La résolution possible dépend de l'intervalle que vous souhaitez exporter. L'API et l'export de données ont les mêmes restrictions de résolution, qui peuvent être consultées ici : [https://api-docs.sensorfact.nl/docs/key-concepts.](https://api-docs.sensorfact.nl/docs/key-concepts) 

#### Vue d'ensemble

Cet article de référence décrit toutes les métriques disponibles via l'export de données (CSV) et l'API. Les métriques sont divisées en deux catégories :

- **Métriques universelles** — renvoyées pour tous les appareils électriques, y compris les capteurs de courant et les compteurs d'énergie.
- **Métriques des compteurs d'énergie** — renvoyées exclusivement pour les compteurs d'énergie, fournissant des mesures électriques étendues.

Conseil : Si une colonne apparaît dans votre export mais affiche des valeurs NULL, vérifiez que votre appareil est un compteur d'énergie et que le type de mesure concerné est pris en charge par votre configuration matérielle.

#### Métriques universelles

Les métriques suivantes sont renvoyées pour tous les appareils électriques, que ce soit dans les exports CSV ou dans les réponses API.

| Nom de colonne | Description |
| --- | --- |
| `external_id` | Un identifiant unique attribué à l'actif sélectionné. Utilisé pour référencer l'appareil dans des systèmes externes et des intégrations. |
| `asset_name` | Le nom de l'actif tel que configuré dans la plateforme. |
| `Customer` | Le nom du site client auquel appartient l'actif. |
| `time_zone` | Le fuseau horaire dans lequel se trouve l'actif. Voir [ici](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) pour une liste complète des identifiants de fuseau horaire pris en charge et leurs descriptions. |
| `measured_at` | L'horodatage de la mesure en heure locale (basé sur le fuseau horaire configuré de l'actif). |
| `utc_time` | L'horodatage de la mesure en Temps Universel Coordonné (UTC). |
| `power` | Puissance active mesurée. Ce champ contient toujours une valeur — si aucune mesure n'a été reçue de l'appareil, la valeur par défaut est 0. Pour les capteurs de courant, il s'agit d'une valeur calculée à partir du courant mesuré, du facteur de puissance configuré et de la tension configurée. Pour les compteurs d'énergie, cette valeur est mesurée directement par l'appareil. |
| `energy` | Énergie calculée. Dérivée directement de la valeur de puissance mesurée ou calculée au fil du temps. |

#### Métriques des compteurs d'énergie

Les métriques suivantes ne sont renvoyées que pour les compteurs d'énergie. Elles n'apparaîtront pas dans les exports des capteurs de courant. Certains champs peuvent contenir des valeurs NULL si un type de mesure spécifique n'est pas pris en charge par le matériel connecté.

| Nom de colonne | Description |
| --- | --- |
| `active_power_total` | Puissance active mesurée. Équivalent au champ power, sauf qu'il affiche les valeurs manquantes (NULL) lorsqu'aucune mesure n'a été reçue de l'appareil. |
| `apparent_power_total` | Puissance apparente mesurée. Représente la puissance totale circulant dans le circuit, incluant les composantes active et réactive. |
| `reactive_power_total` | Puissance réactive mesurée. Représente la part de puissance qui n'effectue pas de travail utile. |
| `current_l1` | Courant mesuré sur la phase 1 (L1). |
| `current_l2` | Courant mesuré sur la phase 2 (L2). |
| `current_l3` | Courant mesuré sur la phase 3 (L3). |
| `current_n` | Courant neutre mesuré. |
| `current_total` | Le courant de ligne triphasé équivalent. Calculé comme : apparent\_power\_total ÷ (√3 × voltage\_ll\_average). |
| `power_factor_total` | Facteur de puissance mesuré (plage de -1 à 1). Représente le rapport entre la puissance active et la puissance apparente. Une valeur de 1 ou -1 indique une charge purement résistive ; les valeurs proches de 0 indiquent une plus faible proportion de puissance réactive. |
| `voltage_average` | Tension moyenne ligne à neutre sur toutes les phases. |
| `voltage_l1_l2` | Tension ligne à ligne mesurée entre la phase 1 (L1) et la phase 2 (L2). |
| `voltage_l1_n` | Tension ligne à neutre mesurée sur la phase 1 (L1). |
| `voltage_l2_l3` | Tension ligne à ligne mesurée entre la phase 2 (L2) et la phase 3 (L3). |
| `voltage_l2_n` | Tension ligne à neutre mesurée sur la phase 2 (L2). |
| `voltage_l3_l1` | Tension ligne à ligne mesurée entre la phase 3 (L3) et la phase 1 (L1). |
| `voltage_l3_n` | Tension ligne à neutre mesurée sur la phase 3 (L3). |
| `voltage_ll_average` | Tension moyenne ligne à ligne sur toutes les paires de phases. |

#### Notes complémentaires

### Valeurs NULL vs. zéro

Il existe une distinction importante entre les champs power et active\_power\_total :

- `power` contient toujours une valeur numérique. Les mesures manquantes sont représentées par 0.
- `active_power_total` peut contenir NULL lorsqu'aucune mesure n'a été reçue, vous permettant de distinguer une lecture nulle réelle d'un point de données manquant.

### Capteurs de courant vs. compteurs d'énergie

Certaines métriques sont calculées différemment selon le type d'appareil :

- **Capteurs de courant** calculent la puissance indirectement à partir du courant mesuré combiné à la tension et au facteur de puissance configurés.
- **Compteurs d'énergie** mesurent la puissance active directement et fournissent un ensemble plus complet de mesures électriques, incluant les tensions et courants par phase ainsi que le facteur de puissance.

### Calcul de l'énergie

Le champ energy est dérivé du champ power par intégration temporelle. Il reflète la consommation d'énergie cumulée sur l'intervalle de mesure.

- [Matériel et installation](https://support.sensorfact.eu/fr/knowledge/mat%C3%A9riel-et-installation?hsLang=fr#main-content)

    - [Électricité](https://support.sensorfact.eu/fr/knowledge/mat%C3%A9riel-et-installation?hsLang=fr#%C3%A9lectricit%C3%A9)
    - [Gestion du gaz](https://support.sensorfact.eu/fr/knowledge/mat%C3%A9riel-et-installation?hsLang=fr#gestion-du-gaz)
    - [Maintenance prédictive](https://support.sensorfact.eu/fr/knowledge/mat%C3%A9riel-et-installation?hsLang=fr#maintenance-pr%C3%A9dictive)
    - [Gestion de l’eau](https://support.sensorfact.eu/fr/knowledge/mat%C3%A9riel-et-installation?hsLang=fr#gestion-de-leau)
    - [Gestion de l’air comprimé](https://support.sensorfact.eu/fr/knowledge/mat%C3%A9riel-et-installation?hsLang=fr#gestion-de-lair-comprim%C3%A9)
    - [OEE](https://support.sensorfact.eu/fr/knowledge/mat%C3%A9riel-et-installation?hsLang=fr#oee)
    - [Température & humidité](https://support.sensorfact.eu/fr/knowledge/mat%C3%A9riel-et-installation?hsLang=fr#temp%C3%A9rature-humidit%C3%A9)
- [Tableau de bord & Analyses](https://support.sensorfact.eu/fr/knowledge/tableau-de-bord-analyses?hsLang=fr#main-content)

    - [Électricité](https://support.sensorfact.eu/fr/knowledge/tableau-de-bord-analyses?hsLang=fr#%C3%A9lectricit%C3%A9)
    - [Gestion de l’air comprimé](https://support.sensorfact.eu/fr/knowledge/tableau-de-bord-analyses?hsLang=fr#gestion-de-lair-comprim%C3%A9)
    - [Rapports](https://support.sensorfact.eu/fr/knowledge/tableau-de-bord-analyses?hsLang=fr#rapports)
    - [Alertes](https://support.sensorfact.eu/fr/knowledge/tableau-de-bord-analyses?hsLang=fr#alertes)
    - [Capteurs d'Eau à Ultrasons](https://support.sensorfact.eu/fr/knowledge/tableau-de-bord-analyses?hsLang=fr#capteurs-deau-%C3%A0-ultrasons)
- [Conseils et retour sur investissement](https://support.sensorfact.eu/fr/knowledge/conseils-et-retour-sur-investissement?hsLang=fr#main-content)

    - [Gestion de l’électricité](https://support.sensorfact.eu/fr/knowledge/conseils-et-retour-sur-investissement?hsLang=fr#gestion-de-l%C3%A9lectricit%C3%A9)
    - [Maintenance prédictive](https://support.sensorfact.eu/fr/knowledge/conseils-et-retour-sur-investissement?hsLang=fr#maintenance-pr%C3%A9dictive)
    - [Air comprimé](https://support.sensorfact.eu/fr/knowledge/conseils-et-retour-sur-investissement?hsLang=fr#air-comprim%C3%A9)
- [Admin & Facturation](https://support.sensorfact.eu/fr/knowledge/admin-facturation?hsLang=fr)
- [Dépannage](https://support.sensorfact.eu/fr/knowledge/d%C3%A9pannage?hsLang=fr#main-content)

    - [Gestion de l’électricité](https://support.sensorfact.eu/fr/knowledge/d%C3%A9pannage?hsLang=fr#gestion-de-l%C3%A9lectricit%C3%A9)
    - [Gestion des impulsions de gaz et d'eau](https://support.sensorfact.eu/fr/knowledge/d%C3%A9pannage?hsLang=fr#gestion-des-impulsions-de-gaz-et-deau)
    - [Gestion de l'eau par ultrasons](https://support.sensorfact.eu/fr/knowledge/d%C3%A9pannage?hsLang=fr#gestion-de-leau-par-ultrasons)

[![Chill listening crop-3](https://support.sensorfact.eu/hs-fs/hubfs/Sensorfact_Logo_CMYK_Blue-1.jpg?width=155&height=40&name=Sensorfact_Logo_CMYK_Blue-1.jpg "Chill listening crop-3")](https://www.sensorfact.eu)

<https://www.sensorfact.eu/contact/#panel0>

Copyright © 2026, Sensorfact B.V.