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
| Nu. | parametru | Observație | exemplu |
|---|---|---|---|
| 1 | nume de utilizator | Numele de utilizator al IAMMETER | Test |
| 2 | parola | 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}
Avansat(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
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 |
definiție valorilor: tensiune, curent, putere activă, Kwh importat, Kwh exportat
{
"date": {
"valori": [
[
230.220,
1.300,
119.000,
1766.590,
0.000
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"reușit": adevărat,
"mesaj": nul
}definiția valorilor: tensiune, curent, putere activă,factor de putere,Kwh importat, Kwh exportat
{
"date":{
"valori":[
[
233,41,
0,718,
111,
0,66,
5724,85,
0
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"reușit":adevărat,
"mesaj":null
}Cele trei matrice dinvalorilereprezintă faza A, faza B și faza C.
Definiția elementului: tensiune, curent, putere activă,factor de putere,Kwh importat, Kwh exportat
{
"date": {
"valori": [
[
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",
"gmtTime": "2020/8/28 5:30:48"
},
"reușit": adevărat,
"mesaj": nul
}{
"date":{
"valori":[
[//faza A
233,8,//tensiune
0,03,//curent
4,//putere activă
0,57,//factor de putere
222,53,//Kwh importat
0 //kwh exportat
],
[//faza B
5,
0,
0,
0,
0,
0
],
[ //faza C
3.1,
0,
0,
0,
0,
0
]
],
"localTime":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"reușit":adevărat,
"mesaj":null
}
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)
| 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 exportat
],
[//faza B
5.5,
0,
0,
0,
0,
0
],
[ //faza C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //date secunde
"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 date
"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":null
}
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: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：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：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：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-ul locului: 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)