IAMMETER-cloud oferă unele API-uri, iar dezvoltatorul poate folosi aceste API-uri pentru a face unele lucrări interesante, cum ar fi integrarea datelor IAMMETER într-un sistem terță parte. Tocmai am deschis aceste API-uri partenerilor noștri de afaceri și unor clienți mari înainte, dar am decis să le deschidem pentru toți clienții noștri acum.
Bine ați venit să ne spuneți părerea dvs. pe forumul nostru.https://imeter.club
API-ul nu poate fi vizitat nelimitat, vom limita numărul zilnic de apeluri pentru fiecare API. Vă rugăm să nu apelați API-ul mai des.
Dacă numărul apelurilor depășește limita orară sau zilnică, API-ul nu va returna nimic.
| Nu. | API | tip limită | orar | Zilnic | descriere |
|---|---|---|---|---|---|
| 1 | /logare utilizator | ip | 5 | 30 | un singur IP poate apela acest api de 5 ori pe oră |
| 2 | /site/meterdata/ | SN | 12 | unui singur SN i se permite să apeleze acest api de 12 ori pe oră | |
| 3 | /site/powerAnalysis | SN | 5 | unui singur SN i se permite să apeleze acest api de 5 ori pe zi | |
| 4 | /site/offlineAnalysis | SN | 5 | unui singur SN i se permite să apeleze acest api de 5 ori pe zi |
Returnează simbolul contului. Tokenul va fi folosit în aproape toate API-urile.
Nu trebuie să apelați acest API decât dacă doriți să reîmprospătați simbolul.Vă rugăm să nu apelați acest API de mai mult de 5 ori într-o oră și de cel mult 30 de ori într-o zi.
Obțineți simbolul contului care este utilizat în toate API-urile.
URL:https://www.iammeter.com/api/v1/user/login
Metodă:post
Această API poate fi testată online înIAMMETER SwaggerUI obține token-ul
| Nu. | parametru | remarcă | exemplu |
|---|---|---|---|
| 1 | nume de utilizator | Numele de utilizator al IAMMETER | Test |
| 2 | parolă | parola IAMMETER | 123456 |
Valoarea simbolului va fi utilizată în toate API-urile de mai jos.
{
"date": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"reușit": adevărat,
"mesaj": nul
}Acest simbol poate fi citit și direct după ce vă conectați la sistem.
Obțineți ultimele date de încărcare cu SN-ul considerat.
Vă rugăm să nu apelați acest API de mai mult de 12 ori într-o oră.
De bază (date metru): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Această API poate fi testată online înAMPERMETRU SwaggerUI
Avansat(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Această API poate fi testată online înIAMMETER SwaggerUI date de măsurareșiAMPERMETRU SwaggerUI meterdata2
Metodă: OBȚINE
Limită: vă rugăm să nu solicitați acest API de mai mult de 288 de ori pe zi (interval de 5 minute).
Diferența dintre de bază și avansat:
De bază: fără PF (factor de putere)
Avansat: cu PF (factor de putere)
| Nume | Tip | Exemplu | |
|---|---|---|---|
| Jeton | Şir | xxx | necesar |
| rtctime | şir | 2025-6-16 | opțional |
definiția valorilor: tensiune, curent, putere activă, kWh importați, kWh exportați
{
„date”: {
„valori”: [
[
230.220, //tensiune
1.300, //curent
119.000, //putere activă
1766.590, //kWh importați
0.000 //kWh exportați
]
],
„ora locală”: „28.08.2020 15:27:33”,
„ora gmt”: „28.08.2020 5:27:33”
},
„reușit”: adevărat,
„mesaj”: nul
}definiția valorilor: tensiune, curent, putere activă,factor de puterekWh importați, kWh exportați.
Deși recunoaștem că plasarea factorului de putere între puterea activă și energia importată nu este optimă, formatul actual este deja configurat în acest fel - vă rugăm să rețineți acest aranjament.
{
„date”:{
„valori”:[
[
233.41, //tensiune
0.718,//curent
111,//putere activă
0.66,//factor de putere
5724.85, //energie importată
0 //energie exportată
]
],
„localTime”: „2023/11/21 14:30:22”,
„gmtTime”: „2023/11/21 6:30:22”
},
„successful”:true,
„message”:null
}Cele trei matrice dinvalorilereprezintă faza A, faza B și faza C.
definiția valorilor: tensiune, curent, putere activă, kWh importați, kWh exportați
{
„date”: {
„valori”: [
[
242.600,//tensiune
1.000,//curent
216.000,//putere activă
32354.600,//energie importată
0.000//energie exportată
],
[
242.600,
1.000,
1986.000,
30536.410,
17704.720
],
[
0.000,
0.000,
0.000,
0.000,
0.000
]
],
„ora locală”: „28.08.2020 15:30:48”,
„ora gmt”: „28.08.2020 5:30:48”
},
„reușit”: adevărat,
„mesaj”: nul
}Definiția elementului: tensiune, curent, putere activă,factor de puterekWh importați, kWh exportați
{
„date”:{
„valori”:[
[//faza A
233.8,//tensiune
0.03,//curent
4,//putere activă
0.57,//factor de putere
222.53,//kWh importați
0 //kWh exportați
],
[//faza B
5,
0,
0,
0,
0,
0
],
[ //faza C
3.1,
0,
0,
0,
0,
0,
0
]
],
„oralocală”: „2023/11/21 14:39:36”,
„oragmt”: „2023/11/21 6:39:36”
},
„reușit”:adevărat,
„mesaj”:nul
}
RTC (Real-Time Clock) este, de asemenea, un parametru în cererea HTTP GET, așa cum se arată mai jos:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16Această solicitare va returna valoarea datelor încărcate ale contorului cea mai apropiată de data specificată (16.06.2025), adică cel mai apropiat moment înregistrat.
Notă: aceste API-uri sunt aceleași ca în capitolul anterior, doar că au fost adăugați câțiva parametri în plus.
Returnează datele istorice pe intervalul și intervalul de timp setat.
Datele instant sunt la interval de 1 min. Există 60*24=1440 de date pe zi. Dacă solicitați datele istorice la interval de 1 min, puteți solicita doar datele de 1,39(2000/1440) zile. Dar dacă solicitați datele în interval de 5 minute, puteți solicita datele de aproape 7 zile.
De bază (lista de date de măsurare):https://www.iammeter.com/api/v1/site/meterdatalist/
**Avansat(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Diferența dintre de bază și avansat:
De bază: fără PF (factor de putere)
Avansat: cu PF (factor de putere)
Această API poate fi testată online înIAMMETER SwaggerUI date de măsurareșiAMPERMETRU SwaggerUI meterdata2
| Nume | Tip | Exemplu | |
|---|---|---|---|
| Jeton | Şir | xxx | necesar |
| interval | număr | 300 | necesar, unitate: secundă |
| timpul de începere | şir | 2023-09-01 | necesar |
| Sfârșitul timpului | şir | 2023-09-07 | necesar |
Date: [tensiune, curent, putere, import energie, export energie, ora utc, ora locală]
{
"date": [
[
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"
]
],
"reușit": adevărat,
"mesaj": nul
}{
"date": [
[
230,//tensiune fazăA
0,//curent
0,//putere activă
468,41,//kWh importate
0,//kWh exportate
230,//FazaB
0,
0,
236,58,
290,77,
230,//Faza 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"
]
],
"reușit": adevărat,
"mesaj": nul
}{
„date”:[
{ //primele date
„rtcTime”: „2023/9/1 0:00:22”,
„gmtTime”: „2023/8/31 16:00:22”,
„valori”:[
[ //faza A
235.2,//tensiune
0.03,//curent
4,//putere activă
0.57,//factor de putere
210.21,//import kWh
0 //kWh exportați
],
[//faza B
5.5,
0,
0,
0,
0,
0
],
[ //faza C
3.3,
0,
0,
0,
0,
0,
0
]
]
},
{ //al doilea date
„rtcTime”: „2023/9/1 8:00:49”,
„gmtTime”: „2023/9/1 0:00:49”,
„valori”: [
[
233.4,
0.03,
4,
0.57,
210.24,
0
],
[
5.4,
0,
0,
0,
0,
0
],
[
3.3,
0,
0,
0,
0,
0
]
]
},
{ //a treia dată
„rtcTime”: „2023/9/1 16:00:24”,
„gmtTime”: „2023/9/1 8:00:24”,
„valori”: [
[
235.6,
0.03,
4,
0.57,
210.27,
0
],
[
5.5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
„reușit”:adevărat,
„mesaj”:nul
}
Returnați rezultatul analizei de putere în timpul specificat.
Vă rugăm să nu apelați acest API de mai mult de 5 ori într-o zi.
URL-ul:https://www.iammeter.com/api/v1/site/powerAnalysis
Metodăobține
Limită: Vă rugăm să nu solicitați acest API per SN de mai mult de 5 ori în fiecare zi.
| Nume | Tip | Exemplu | |
|---|---|---|---|
sn |
Şir | xxx | necesar |
timpul de începere |
Şir | 2023-09-01 | opțional |
Sfârșitul timpului |
Şir | 2023-09-07 | opțional |
Notă:
medie: citirea medie a puterii în acest interval de timp.
averageDaytime: citire medie de putere în timpul zilei (8:00am-8:00pm) în acest interval de timp.
minim: citire de putere minimă în acest interval de timp.
maxim: citirea puterii maxime în acest interval de timp.
{
"date": {
"startTime": "2023-09-01",
"endTime": "2023-09-07",
„medie”: 862,6,
„medie pe timp de zi”: 836,9,
"minimum": 259,0,
„maximum”: 3999,0
},
"reușit": adevărat,
"mesaj": nul
}Returnați rezultatul analizei de putere din ultimele 7 zile.
Returnați rezultatul analizei de putere din ziua specificată
Returnează starea deconectarii cu SN-ul considerat în timpul specificat.
Vă rugăm să nu apelați acest API de mai mult de 5 ori într-o zi.
URL-ul：https://www.iammeter.com/api/v1/site/offlineAnalysis
Metodă：obține
Limită: Vă rugăm să nu solicitați acest API per SN de mai mult de 5 ori în fiecare zi.
| Nume | Tip | Exemplu | |
|---|---|---|---|
sn |
Şir | xxxx | necesar |
timpul de începere |
Şir | 2023-09-01 | opțional |
Sfârșitul timpului |
Şir | 2023-09-07 | opțional |
interval(unitate:minut) |
Număr | 5 | opțional |
Notă:
Există un total de 10080 de minute în acest interval de timp.
Timpul total offline este de 906 minute în acest interval de timp.
Intervalul offline care este mai mare de 5 minute este listat în matrice.
{
"date": {
"startTime": "2023-09-05",
"endTime": "2023-09-11",
"Număr offline": 906,
"Număr total": 10080,
"lista": [
{
"startTime": "2023/9/5 0:00:00",
"endTime": "2023/9/5 15:06:14",
"durata": 906
}
]
},
"reușit": adevărat,
"mesaj": nul
}Returnează rezultatul analizei offline din ziua specificată
Returnează cea mai recentă valoare a tuturor contorului de energie din acest cont.
URL-ul：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metodă：obține
Limită: Asigurați-vă că nu faceți solicitări către acest API mai des decât o dată la fiecare 5 minute.
| Nume | Tip | Exemplu | |
|---|---|---|---|
| Jeton | Şir | xxx | necesar |
{
"date":[
{
"sn":"DA2BED94",
"valori":[
223,71,
1,74,
225,
14761.03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn":"B384789C",
"valori":[
[
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
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"674B1E5D",
"valori":[
[
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",
"valori":[
[
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
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"3FE34ABE",
"valori":[
[
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"
}
],
"reușit":adevărat,
"mesaj":null
}
Preluați valorile orare/zile de kWh pentru generarea invertorului și schimbul de rețea (atât exportate, cât și importate)
URL-ul：https://www.iammeter.com/api/v1/site/energyhistory/?timpul de începere={2024-05-05}&Sfârșitul timpului={2024-07-07}&a se grupa cu=&Jeton={2be6d1xxxxxxcc688}
Metodăobține
Limită：
groupby = zi: date 90 zile (date 90 buc)
groupby = oră: date de 7 zile (date de 168 buc)
| Nume | Tip | Des | Exemplu | |
|---|---|---|---|---|
| Jeton | Şir | simbolul contului | xxx | necesar |
| ID-ul locului | număr | ID-ul locului | necesar | |
| timpul de începere | şir | ora de începere a acestei reveniri api | 2023-09-01 | necesar |
| Sfârșitul timpului | şir | timpul de oprire al acestei reveniri api | 2023-09-07 | necesar |
| gruphy | enumerare | selectați intervalul de returnare a datelor (oră/zi) | zi/oră | necesar |
ID_loc: Locațiile mele->Editare
place_id:1360
startTime=2024-05-05
endTime=2024-05-07
groupby=zi
{
"date": [{
"ora": "2024/5/5 0:00:00",
"randament": 0,
"de laGrid": 9,62,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/6 0:00:00",
"randament": 0,
"fromGrid": 9.16,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
}
],
"reușit": adevărat,
"mesaj": nul
}place_id:2393
startTime=2024-05-05
endTime=2024-05-07
groupby=zi
{
"date": [{
"ora": "2024/5/5 0:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/6 0:00:00",
"randament": 0,1,
"de laGrid": 0,22,
"toGrid": 7,15,
"specialLoad": 0,
"Autoutilizare": 0
}
],
"reușit": adevărat,
"mesaj": nul
}place_id:2393
startTime=2024-05-05
endTime=2024-05-06
groupby=ora
{
"date": [{
"ora": "2024/5/5 0:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 1:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 2:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 3:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 4:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 5:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 6:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 7:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 8:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 9:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 10:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 11:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 12:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 13:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 14:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 15:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 16:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 17:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 18:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 19:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 20:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 21:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 22:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
},
{
"ora": "2024/5/5 23:00:00",
"randament": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"Autoutilizare": 0
}
],
"reușit": adevărat,
"mesaj": nul
}API-ul contorului de energie WiFi
Ce capabilități oferă IAMMETER?
Ce tip de contor electric se potrivește cel mai bine nevoilor dumneavoastră?
Cum găsiți contorul de putere în funcție de cerințele dvs
Utilizați contorul de energie în trei faze așa cum preferați
Contor de energie Wi-Fi trifazat (WEM3080T)
Contor de energie Wi-Fi monofazat (WEM3080)
Contor de energie Wi-Fi trifazat (WEM3046T)
Contor de energie Wi-Fi trifazat (WEM3050T)