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é
API du compteur d'énergie WiFi
Compteur d'énergie WiFi triphasé
Utilisez le compteur d'énergie triphasé comme vous le souhaitez
Compteur d'énergie Wi-Fi triphasé
Compteur d'énergie Wi-Fi monophasé