IAMMETER-Cloud fournit des API, et les développeurs peuvent utiliser ces API pour effectuer des tâches intéressantes, comme intégrer les données d'IAMMETER dans un système tiers. Nous avons ouvert ces API uniquement à nos partenaires commerciaux et à certains grands clients auparavant, mais nous avons décidé de les ouvrir à tous nos clients maintenant.
N'hésitez pas à nous faire part de vos réflexions sur notre forum. https://imeter.club
Les API ne peuvent pas être utilisées sans limite ; nous limiterons le nombre d'appels quotidiens pour chaque API. Veuillez ne pas appeler l'API trop fréquemment.
Si le nombre d'appels dépasse la limite horaire ou quotidienne, l'API ne retournera rien.
| N° | API | type de limite | horaire | quotidien | description |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | une seule IP peut appeler cette API 5 fois par heure |
| 2 | /site/meterdata/ | SN | 12 | un seul SN peut appeler cette API 12 fois par heure | |
| 3 | /site/powerAnalysis | SN | 5 | un seul SN peut appeler cette API 5 fois par jour | |
| 4 | /site/offlineAnalysis | SN | 5 | un seul SN peut appeler cette API 5 fois par jour |
Retourne le jeton du compte. Le jeton sera utilisé dans presque toutes les API.
Vous n'avez pas besoin d'appeler cette API sauf si vous souhaitez rafraîchir le jeton. Veuillez ne pas appeler cette API plus de 5 fois par heure, et pas plus de 30 fois par jour.
Obtenez le jeton du compte qui est utilisé dans toutes les API.
URL : https://www.iammeter.com/api/v1/user/login
Méthode : post
Cette API peut être testée en ligne dans IAMMETER SwaggerUI get token
| N° | paramètre | remarque | exemple |
|---|---|---|---|
| 1 | user name | Nom d'utilisateur IAMMETER | test |
| 2 | password | Mot de passe IAMMETER | 123456 |
La valeur du jeton sera utilisée dans toutes les API ci-dessous.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Ce jeton peut également être lu directement après vous être connecté au système.
Obtenez les dernières données envoyées avec le SN concerné.
Veuillez ne pas appeler cette API plus de 12 fois par heure.
De base (meterdata) : https://www.iammeter.com/api/v1/site/meterdata/{sn}
Cette API peut être testée en ligne dans IAMMETER SwaggerUI
Avancé (meterdata2) : https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Cette API peut être testée en ligne dans IAMMETER SwaggerUI meterdata et IAMMETER SwaggerUI meterdata2
Méthode : GET
Limite : veuillez ne pas demander cette API plus de 288 fois par jour (intervalle de 5 minutes).
La différence entre les versions de base et avancée :
Version de base : sans PF (Power factor / facteur de puissance)
Version avancée : avec PF (Power factor / facteur de puissance)
| Nom | Type | Exemple | |
|---|---|---|---|
| Token | String | xxx | requis |
| rtctime | string | 2025-6-16 | facultatif |
Définition des valeurs : tension, courant, puissance active, kWh importés, kWh exportés
{
"data": {
"values": [
[
230.220, //tension
1.300, //courant
119.000,//puissance active
1766.590, //kWh importés
0.000 //kWh exportés
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"successful": true,
"message": null
}
Définition des valeurs : tension, courant, puissance active, facteur de puissance, kWh importés, kWh exportés.
Nous reconnaissons que le placement du facteur de puissance entre la puissance active et l'énergie importée n'est pas optimal, mais le format actuel est déjà établi de cette façon — veuillez prendre note de cette disposition.
{
"data":{
"values":[
[
233.41, //tension
0.718,//courant
111,//puissance active
0.66,//facteur de puissance
5724.85, //énergie importée
0 //énergie exportée
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"successful":true,
"message":null
}
Les trois tableaux dans values représentent la Phase A, la Phase B et la Phase C.
Définition des valeurs : tension, courant, puissance active, kWh importés, kWh exportés
{
"data": {
"values": [
[
242.600,//tension
1.000,//courant
216.000,//puissance active
32354.600,//énergie importée
0.000//énergie exportée
],
[
242.600,
1.000,
1986.000,
30536.410,
17704.720
],
[
0.000,
0.000,
0.000,
0.000,
0.000
]
],
"localTime": "2020/8/28 15:30:48",
"gmtTime": "2020/8/28 5:30:48"
},
"successful": true,
"message": null
}
Définition des éléments : tension, courant, puissance active, facteur de puissance, kWh importés, kWh exportés
{
"data":{
"values":[
[//phase A
233.8,//tension
0.03,//courant
4,//puissance active
0.57,//facteur de puissance
222.53,//kWh importés
0 //kWh exportés
],
[//phase B
5,
0,
0,
0,
0,
0
],
[ //phase C
3.1,
0,
0,
0,
0,
0
]
],
"localTime":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"successful":true,
"message":null
}
Le RTC (Real-Time Clock / horloge temps réel) est également un paramètre dans la requête HTTP GET, comme illustré ci-dessous :
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Cette requête retournera la valeur de données de compteur la plus proche de la date spécifiée (2025-6-16), c'est-à-dire le point temporel enregistré le plus proche.
Remarque : ces API sont les mêmes que celles du chapitre précédent, seuls quelques paramètres supplémentaires ont été ajoutés.
Retourne les données historiques selon l'intervalle et la plage horaire définis.
Les données instantanées sont à intervalle de 1 minute. Il y a 60*24 = 1440 éléments de données par jour. Si vous demandez les données historiques à intervalle de 1 minute, vous ne pouvez demander que les données de 1,39 (2000/1440) jours. Mais si vous demandez les données à intervalle de 5 minutes, vous pouvez demander les données d'environ 7 jours.
De base (meterdatalist) : https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Avancé (meterdatalist2) : https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
La différence entre les versions de base et avancée :
Version de base : sans PF (Power factor / facteur de puissance)
Version avancée : avec PF (Power factor / facteur de puissance)
Cette API peut être testée en ligne dans IAMMETER SwaggerUI meterdata et IAMMETER SwaggerUI meterdata2
| Nom | Type | Exemple | |
|---|---|---|---|
| Token | String | xxx | requis |
| interval | number | 300 | requis, unité : seconde |
| startTime | string | 2023-09-01 | requis |
| endTime | string | 2023-09-07 | requis |
Données : [tension, courant, puissance, énergie importée, énergie exportée, heure UTC, heure locale]
{
"data": [
[
227.73,
1.45,
172,
13121.56,
0,
"2023/9/12 0:00:34",
"2023/9/11 14:00:34"
],
[
229.43,
1.45,
172,
13121.56,
0,
"2023/9/12 0:01:33",
"2023/9/11 14:01:33"
]
],
"successful": true,
"message": null
}
{
"data": [
[
230,//phaseA tension
0,//courant
0,//puissance active
468.41,//kWh importés
0,//kWh exportés
230,//PhaseB
0,
0,
236.58,
290.77,
230,//Phase C
0,
0,
258.62,
0,
"2023/9/12 0:00:15",
"2023/9/11 16:00:15"
],
[
230,
0,
0,
468.41,
0,
230,
0,
0,
236.58,
290.77,
230,
0,
0,
258.62,
0,
"2023/9/12 0:02:08",
"2023/9/11 16:02:08"
]
],
"successful": true,
"message": null
}
{
"data":[
{ //première donnée
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"values":[
[ //phase A
235.2,//tension
0.03,//courant
4,//puissance active
0.57,//facteur de puissance
210.21,//kWh importés
0 //kWh exportés
],
[//phase B
5.5,
0,
0,
0,
0,
0
],
[ //phase C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //deuxième donnée
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"values":[
[
233.4,
0.03,
4,
0.57,
210.24,
0
],
[
5.4,
0,
0,
0,
0,
0
],
[
3.3,
0,
0,
0,
0,
0
]
]
},
{ //troisième donnée
"rtcTime":"2023/9/1 16:00:24",
"gmtTime":"2023/9/1 8:00:24",
"values":[
[
235.6,
0.03,
4,
0.57,
210.27,
0
],
[
5.5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"successful":true,
"message":null
}
Retourne le résultat de l'analyse de puissance à la période spécifiée.
Veuillez ne pas appeler cette API plus de 5 fois par jour.
URL : https://www.iammeter.com/api/v1/site/powerAnalysis
Méthode : get
Limite : veuillez ne pas demander cette API par SN plus de 5 fois par jour.
| Nom | Type | Exemple | |
|---|---|---|---|
sn |
String | xxx | requis |
startTime |
String | 2023-09-01 | facultatif |
endTime |
String | 2023-09-07 | facultatif |
Remarque :
average : lecture de puissance moyenne pendant cette plage horaire.
averageDaytime : lecture de puissance moyenne en journée (8h00-20h00) pendant cette plage horaire.
minimum : lecture de puissance minimale pendant cette plage horaire.
maximum : lecture de puissance maximale pendant cette plage horaire.
{
"data": {
"startTime": "2023-09-01",
"endTime": "2023-09-07",
"average": 862.6,
"averageDaytime": 836.9,
"minimum": 259.0,
"maximum": 3999.0
},
"successful": true,
"message": null
}
Retourne le résultat de l'analyse de puissance des 7 derniers jours.
Retourne le résultat de l'analyse de puissance du jour spécifié.
Retourne l'état de déconnexion pour le SN concerné à la période spécifiée.
Veuillez ne pas appeler cette API plus de 5 fois par jour.
URL : https://www.iammeter.com/api/v1/site/offlineAnalysis
Méthode : Get
Limite : veuillez ne pas demander cette API par SN plus de 5 fois par jour.
| Nom | Type | Exemple | |
|---|---|---|---|
sn |
String | xxxx | requis |
startTime |
String | 2023-09-01 | facultatif |
endTime |
String | 2023-09-07 | facultatif |
interval (unité : minute) |
Number | 5 | facultatif |
Remarque :
Il y a un total de 10080 minutes dans cette plage horaire.
Le temps hors ligne total est de 906 minutes dans cette plage horaire.
L'intervalle hors ligne supérieur à 5 minutes est listé dans le tableau.
{
"data": {
"startTime": "2023-09-05",
"endTime": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"list": [
{
"startTime": "2023/9/5 0:00:00",
"endTime": "2023/9/5 15:06:14",
"duration": 906
}
]
},
"successful": true,
"message": null
}
Retourne le résultat de l'analyse hors ligne du jour spécifié.
Retourne la dernière valeur de tous les compteurs d'énergie de ce compte.
URL : https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Méthode : Get
Limite : veuillez vous assurer de ne pas faire de requêtes à cette API plus d'une fois toutes les 5 minutes.
| Nom | Type | Exemple | |
|---|---|---|---|
| Token | String | xxx | requis |
{
"data":[
{
"sn":"DA2BED94",
"values":[
223.71,
1.74,
225,
14761.03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn":"B384789C",
"values":[
[
248.9,
13.9,
3356,
21228,
0,
null,
null
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
null,
null
],
[
null,
null,
null,
null,
null,
null,
null
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
null,
null
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"674B1E5D",
"values":[
[
220.4,
1.86,
377,
5345.985,
20.565
],
[
220.4,
1.86,
377,
5367.715,
0.033
],
[
220.5,
1.86,
377,
5369.532,
0.033
]
],
"gmtTime":"2024/2/22 3:45:50"
},
{
"sn":"59C9AB8D",
"values":[
[
245.3,
6.5,
1604,
46055.7,
0,
null,
null
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
null,
null
],
[
null,
null,
null,
null,
null,
null,
null
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
null,
null
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"3FE34ABE",
"values":[
[
230,
15.9,
3650.1,
2704.35,
0,
49.99,
0.94
],
[
230,
-11.5,
-2650.1,
1411.31,
1722.35,
49.99,
0.94
],
[
230,
4.3,
1000,
1946.03,
0,
49.99,
0.94
]
],
"gmtTime":"2024/2/22 3:46:01"
}
],
"successful":true,
"message":null
}
Récupérez les valeurs kWh horaires/quotidiennes pour la génération de l'onduleur et les échanges avec le réseau (exportés et importés).
Méthode : get
Limite :
groupby = day : 90 jours de données (90 éléments)
groupby = hour : 7 jours de données (168 éléments)
| Nom | Type | Description | Exemple | |
|---|---|---|---|---|
| Token | String | jeton du compte | xxx | requis |
| place_ID | number | ID du lieu | requis | |
| startTime | string | heure de début du retour de cette API | 2023-09-01 | requis |
| endTime | string | heure de fin du retour de cette API | 2023-09-07 | requis |
| groupby | enum | sélectionner l'intervalle des données retournées (heure/jour) | day/hour | requis |
Place_ID : Mes Lieux -> Modifier
place_id:1360
startTime=2024-05-05
endTime=2024-05-07
groupby=day
{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 9.62,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/6 0:00:00",
"yield": 0,
"fromGrid": 9.16,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
}
],
"successful": true,
"message": null
}
place_id:2393
startTime=2024-05-05
endTime=2024-05-07
groupby=day
{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/6 0:00:00",
"yield": 0.1,
"fromGrid": 0.22,
"toGrid": 7.15,
"specialLoad": 0,
"selfUse": 0
}
],
"successful": true,
"message": null
}
place_id:2393
startTime=2024-05-05
endTime=2024-05-06
groupby=hour
{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 1:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 2:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 3:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 4:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 5:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 6:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 7:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 8:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 9:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 10:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 11:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 12:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 13:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 14:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 15:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 16:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 17:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 18:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 19:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 20:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 21:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 22:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 23:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
}
],
"successful": true,
"message": null
}
API du compteur d'énergie WiFi
Quelles sont les capacités offertes par IAMMETER ?
Quel type de compteur électrique correspond le mieux à vos besoins ?
Comment trouver le compteur d'énergie adapté à vos besoins
Utilisez le compteur d'énergie triphasé comme vous le souhaitez
Compteur d'énergie Wi-Fi triphasé (WEM3080T)
Compteur d'énergie Wi-Fi monophasé (WEM3080)
Compteur d'énergie Wi-Fi triphasé (WEM3046T)
Compteur d'énergie Wi-Fi triphasé (WEM3050T)