IAMMETER-cloud fournit certaines API, et le développeur peut utiliser ces API pour effectuer un travail intéressant, comme l'intégration des données d'IAMMETER à un système tiers. Nous venons d'ouvrir ces API à nos partenaires commerciaux et à certains gros clients auparavant, mais nous avons décidé de les ouvrir maintenant à tous nos clients.
Bienvenue à nous faire part de votre réflexion sur notre forum.https://imeter.club
L'API ne peut pas être visitée de manière illimitée, nous limiterons le nombre d'appels quotidiens pour chaque API. Veuillez ne pas appeler l'API plus fréquemment.
Si le nombre d'appels dépasse la limite horaire ou quotidienne, l'API ne renverra rien.
| Non. | API | type de limite | Horaire | du quotidien | La description |
|---|---|---|---|---|---|
| 1 | /Utilisateur en ligne | adresse IP | 5 | 30 | une seule adresse IP est autorisée à appeler cette API 5 fois par heure |
| 2 | /site/meterdata/ | SN | 12 | un seul SN est autorisé à appeler cette API 12 fois par heure | |
| 3 | /site/powerAnalyse | SN | 5 | un seul SN est autorisé à appeler cette API 5 fois par jour | |
| 4 | /site/analyse hors ligne | SN | 5 | un seul SN est autorisé à appeler cette API 5 fois par jour |
Renvoyez 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 actualiser 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:poste
Cette API peut être testée en ligne dansIAMMETER SwaggerUI obtenir un jeton
| Non. | paramètre | Remarque | Exemple |
|---|---|---|---|
| 1 | nom d'utilisateur | Nom d’utilisateur de IAMMETER | test |
| 2 | Mot de passe | mot de passe de IAMMETER | 123456 |
La valeur du jeton sera utilisée dans toutes les API ci-dessous.
{
"données" : {
"identifiant": 2025,
"jeton": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"réussi" : vrai,
"message": nul
}Ce jeton peut également être lu directement après votre connexion au système.
Obtenez les dernières données de téléchargement avec le SN considéré.
Veuillez ne pas appeler cette API plus de 12 fois en une heure.
De base (données du compteur): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Cette API peut être testée en ligne dansIAMMETER SwaggerUI
Avancé (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Cette API peut être testée en ligne dansDonnées de compteur IAMMETER SwaggerUIetIAMMETER SwaggerUI meterdata2
Méthode: OBTENIR
Limite: veuillez ne pas demander cette API plus de 288 fois par jour (intervalle de 5 minutes).
La différence entre basique et avancé :
Basic : sans PF (facteur de puissance)
Avancé : avec PF (facteur de puissance)
| Nom | Taper | Exemple | |
|---|---|---|---|
| Jeton | Chaîne | xxx | requis |
| rtctime | Chaîne | 2025-6-16 | facultatif |
Définition des valeurs : tension, courant, puissance active, Kwh importé, Kwh exporté
{
« données » : {
« valeurs » : [
[
230,220, //tension
1,300, //courant
119,000, //puissance active
1766,590, //kWh importés
0,000 //kWh exportés
]
],
« heure locale » : « 28/08/2020 15:27:33 »,
« heure gmt » : « 28/08/2020 5:27:33 »
},
« réussite » : vrai,
« message » : nul
}Définition des valeurs : tension, courant, puissance active,facteur de puissance,kWh importés, kWh exportés.
Bien que nous reconnaissions que le placement du facteur de puissance entre la puissance active et l'énergie importée n'est pas optimal, le format actuel est déjà configuré de cette façon. Veuillez tenir compte de cette disposition.
{
"données":{
"valeurs":[
[
233,41, //tension
0,718, //courant
111, //puissance active
0,66, //facteur de puissance
5724,85, //énergie importée
0 //énergie exportée
]
],
"heurelocale": "21/11/2023 14:30:22",
"heuregmt": "21/11/2023 6:30:22"
},
"réussite":true,
"message":null
}Les trois tableaux dansvaleursreprésentent la phase A, la phase B et la phase C.
Définition des valeurs : tension, courant, puissance active, Kwh importé, Kwh exporté
{
« données » : {
« valeurs » : [
[
242,600,//tension
1,000,//courant
216,000,//puissance active
32 354,600,//énergie importée
0,000,//énergie exportée
],
[
242,600,
1,000,
1 986,000,
30 536,410,
17 704,720
],
[
0,000,
0,000,
0,000,
0,000
]
],
« heure locale » : « 2020/8/28 15:30:48 »,
« gmtTime » : « 2020/8/28 5:30:48 »
},
« succès » : vrai,
« message » : nul
}Définition de l'élément : tension, courant, puissance active,facteur de puissance, Kwh importé, Kwh exporté
{
"données" : {
« valeurs » : [
[//phase A
233,8,//tension
0,03,//courant
4,//puissance active
0,57,//facteur de puissance
222,53,//Kwh importés
0 //Kwh exporté
],
[//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"
},
"réussi" : vrai,
"message": nul
}
Le RTC (Real-Time Clock) est également un paramètre dans la requête HTTP GET, comme indiqué ci-dessous :
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16Cette requête renverra la valeur des données du compteur téléchargées 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, elles ajoutent simplement quelques paramètres supplémentaires
Renvoie les données historiques sur l’intervalle et la plage de temps définis.
Les données instantanées sont dans un intervalle de 1 minute. Il y a 60*24=1440 données par jour. Si vous demandez les données historiques dans un 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 dans un intervalle de 5 minutes, vous pouvez demander les données sur près de 7 jours.
Basic (liste de données de compteurs):https://www.iammeter.com/api/v1/site/meterdatalist/
**Avancé (meterdatalist2) :**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
La différence entre basique et avancé :
Basic : sans PF (facteur de puissance)
Avancé : avec PF (facteur de puissance)
Cette API peut être testée en ligne dansDonnées de compteur IAMMETER SwaggerUIetIAMMETER SwaggerUI meterdata2
| Nom | Taper | Exemple | |
|---|---|---|---|
| Jeton | Chaîne | xxx | requis |
| intervalle | nombre | 300 | requis, unité : seconde |
| Heure de début | Chaîne | 2023-09-01 | requis |
| heure de fin | Chaîne | 2023-09-07 | requis |
Données : [tension, courant, puissance, énergie d'importation, énergie d'exportation, heure UTC, heure locale]
{
"données": [
[
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"
]
],
"réussi" : vrai,
"message": nul
}{
"données": [
[
Tension 230,//phaseA
0,//actuel
0,//puissance active
468,41,//kWh importés
0,//kWh exporté
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"
]
],
"réussi" : vrai,
"message" : nul
}{
"données" : [
{ //premières données
"rtcTime": "2023/9/1 0:00:22",
"heure gmt": "31/8/2023 16:00:22",
« valeurs » : [
[ //phase A
235,2,//tension
0,03,//courant
4,//puissance active
0,57,//facteur de puissance
210,21,//importation Kwh
0 //Kwh exporté
],
[//phase B
5.5,
0,
0,
0,
0,
0
],
[ //phase C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //seconde donnée
"rtcTime": "2023/9/1 8:00:49",
"heure gmt": "1/9/2023 0:00:49",
« valeurs » : [
[
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",
"heure gmt": "1/9/2023 8:00:24",
« valeurs » : [
[
235.6,
0,03,
4,
0,57,
210.27,
0
],
[
5.5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"réussi" : vrai,
"message": nul
}
Renvoie le résultat de l'analyse de puissance dans le délai spécifié.
Veuillez ne pas appeler cette API plus de 5 fois par jour.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Méthode: OBTENIR
Limite: Veuillez ne pas demander cette API par SN plus de 5 fois par jour.
| Nom | Taper | Exemple | |
|---|---|---|---|
SN |
Chaîne | xxx | requis |
Heure de début |
Chaîne | 2023-09-01 | facultatif |
heure de fin |
Chaîne | 2023-09-07 | facultatif |
Noter:
moyenne : lecture de puissance moyenne pendant cette plage de temps.
moyenneJour : lecture de puissance moyenne pendant la 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.
{
"données" : {
"startTime": "2023-09-01",
"endTime": "2023-09-07",
"moyenne": 862,6,
« moyenne de jour » : 836,9,
"minimum": 259,0,
« maximum » : 3999,0
},
"réussi" : vrai,
"message": nul
}Renvoie le résultat de l’analyse de puissance des 7 derniers jours.
Renvoie le résultat de l'analyse de puissance du jour spécifié
Renvoie l'état de déconnexion avec le SN considéré dans le délai spécifié.
Veuillez ne pas appeler cette API plus de 5 fois par jour.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Méthode：Obtenir
Limite: Veuillez ne pas demander cette API par SN plus de 5 fois par jour.
| Nom | Taper | Exemple | |
|---|---|---|---|
SN |
Chaîne | xxxx | requis |
Heure de début |
Chaîne | 2023-09-01 | facultatif |
heure de fin |
Chaîne | 2023-09-07 | facultatif |
intervalle(unité :minute) |
nombre | 5 | facultatif |
Noter:
Il y a au total 10 080 minutes dans cette plage horaire.
La durée totale hors ligne est de 906 minutes dans cette plage horaire.
L’intervalle hors ligne supérieur à 5 minutes est répertorié dans le tableau.
{
"données" : {
"startTime": "2023-09-05",
"endTime": "2023-09-11",
« compte hors ligne » : 906,
"totalCount": 10080,
"liste": [
{
"startTime": "2023/9/5 0:00:00",
"endTime": "2023/9/5 15:06:14",
"durée" : 906
}
]
},
"réussi" : vrai,
"message": nul
}Renvoie le résultat de l'analyse hors ligne du jour spécifié
Renvoie 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：Obtenir
Limite: Veuillez vous assurer de ne pas envoyer de requêtes à cette API plus d'une fois toutes les 5 minutes.
| Nom | Taper | Exemple | |
|---|---|---|---|
| Jeton | Chaîne | xxx | requis |
{
"données" : [
{
"sn": "DA2BED94",
« valeurs » : [
223.71,
1,74,
225,
14761.03,
0
],
"heure gmt": "22/02/2024 3:46:20"
},
{
"sn": "B384789C",
« valeurs » : [
[
248.9,
13.9,
3356,
21228,
0,
nul,
nul
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
nul,
nul
],
[
nul,
nul,
nul,
nul,
nul,
nul,
nul
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
nul,
nul
]
],
"heure gmt": "22/02/2024 3:45:15"
},
{
"sn": "674B1E5D",
« valeurs » : [
[
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
]
],
"heure gmt": "22/02/2024 3:45:50"
},
{
"sn": "59C9AB8D",
« valeurs » : [
[
245.3,
6.5,
1604,
46055.7,
0,
nul,
nul
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
nul,
nul
],
[
nul,
nul,
nul,
nul,
nul,
nul,
nul
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
nul,
nul
]
],
"heure gmt": "22/02/2024 3:45:15"
},
{
"sn": "3FE34ABE",
« valeurs » : [
[
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
]
],
"heure gmt": "22/02/2024 3:46:01"
}
],
"réussi" : vrai,
"message": nul
}
Récupérez les valeurs horaires/quotidiennes en kWh pour la génération d'onduleurs et l'échange de réseau (à la fois exportés et importés)
URL：https://www.iammeter.com/api/v1/site/energyhistory/?Heure de début={2024-05-05}&heure de fin={2024-07-07}&par groupe=&Jeton={2be6d1xxxxxxcc688}
Méthode: OBTENIR
Limite：
groupby = jour : données de 90 jours (données de 90 pièces)
groupby = heure : données sur 7 jours (données de 168 pièces)
| Nom | Taper | Des | Exemple | |
|---|---|---|---|---|
| Jeton | Chaîne | jeton du compte | xxx | requis |
| ID_lieu | nombre | Identifiant du lieu | requis | |
| Heure de début | Chaîne | heure de début de ce retour d'API | 2023-09-01 | requis |
| heure de fin | Chaîne | heure d'arrêt de ce retour d'API | 2023-09-07 | requis |
| par groupe | énumération | sélectionnez l'intervalle de données de retour (heure/jour) | jour/heure | requis |
ID_lieu: Mes adresses->Modifier
id_lieu : 1360
heure de début = 05/05/2024
heure de fin = 07/05/2024
groupby=jour
{
"données": [{
"heure": "2024/5/5 0:00:00",
"rendement" : 0,
"fromGrid": 9,62,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/6 0:00:00",
"rendement" : 0,
"fromGrid": 9.16,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
}
],
"réussi" : vrai,
"message": nul
}id_lieu : 2393
heure de début = 05/05/2024
heure de fin = 07/05/2024
groupby=jour
{
"données" : [{
"heure": "2024/5/5 0:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/6 0:00:00",
"rendement" : 0,1,
"fromGrid": 0,22,
"vers la grille": 7.15,
"charge spéciale" : 0,
« autoUtilisation » : 0
}
],
"réussi" : vrai,
"message" : nul
}id_lieu : 2393
heure de début = 05/05/2024
heure de fin = 06/05/2024
groupby=heure
{
"données": [{
"heure": "2024/5/5 0:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 1:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 2:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 3:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 4:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 5:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 6:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 7:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 8:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 9:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 10:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 11:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 12:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 13:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 14:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 15:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 16:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 17:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 18:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 19:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 20:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 21:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 22:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
},
{
"heure": "2024/5/5 23:00:00",
"rendement" : 0,
"fromGrid": 0,
"vers la grille": 0,
"charge spéciale" : 0,
« autoUtilisation » : 0
}
],
"réussi" : vrai,
"message": nul
}API du compteur d'énergie WiFi
Quelles fonctionnalités offre IAMMETER ?
Quel type de compteur électrique correspond le mieux à vos besoins ?
Comment trouver le wattmètre par rapport à 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)