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ă
API-ul contorului de energie WiFi
Contor de energie WiFi trifazic
Utilizați contorul de energie în trei faze așa cum preferați
Contor de energie Wi-Fi trifazic
Contor de energie Wi-Fi monofazat