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 | 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
| 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}
Avancé (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
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 |
Définition des valeurs : tension, courant, puissance active, Kwh importé, Kwh exporté
{
"données" : {
"valeurs" : [
[
230.220,
1.300,
119.000,
1766.590,
0,000
]
],
"localTime": "2020/8/28 15:27:33",
"heure gmt": "28/8/2020 5:27:33"
},
"réussi" : vrai,
"message" : nul
}Définition des valeurs : tension, courant, puissance active,facteur de puissance, Kwh importé, Kwh exporté
{
"données" : {
« valeurs » : [
[
233.41,
0,718,
111,
0,66,
5724.85,
0
]
],
"localTime": "2023/11/21 14:30:22",
"heure gmt": "21/11/2023 6:30:22"
},
"réussi" : vrai,
"message": nul
}Les trois tableaux dansvaleursreprésentent la phase A, la phase B et la phase C.
Définition de l'élément : tension, courant, puissance active,facteur de puissance, Kwh importé, Kwh exporté
{
"données" : {
"valeurs" : [
[
242.600,
1.000,
216 000,
32354.600,
0,000
],
[
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",
"heure gmt": "28/8/2020 5:30:48"
},
"réussi" : vrai,
"message" : nul
}{
"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
}
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)
| 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 |
| 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)