Oblak IAMMETER ponuja nekaj API-jev in razvijalec lahko te API-je uporabi za zanimivo delo, kot je integracija podatkov IAMMETER v sistem tretje osebe. Te API-je smo že prej odprli našim poslovnim partnerjem in nekaterim velikim strankam, zdaj pa smo se odločili, da jih odpremo vsem našim strankam.
Dobrodošli, da nam sporočite svoje mnenje na našem forumu.https://imeter.club
API-ja ni mogoče obiskati neomejeno, omejili bomo dnevno število klicev za vsak API. Prosimo, ne kličite API-ja pogosteje.
Če število klicev preseže urno ali dnevno omejitev, API ne bo vrnil ničesar.
| št. | API | vrsta omejitve | urno | Dnevno | opis |
|---|---|---|---|---|---|
| 1 | /uporabnik/prijava | ip | 5 | 30 | samo en IP lahko pokliče ta API 5-krat na uro |
| 2 | /site/meterdata/ | SN | 12 | samo en SN sme poklicati ta API 12-krat na uro | |
| 3 | /site/powerAnalysis | SN | 5 | samo en SN lahko pokliče ta API 5-krat na dan | |
| 4 | /site/offlineAnalysis | SN | 5 | samo en SN lahko pokliče ta API 5-krat na dan |
Vrnite žeton računa. Žeton bo uporabljen v skoraj vseh API-jih.
Tega API-ja vam ni treba klicati, razen če želite osvežiti žeton.Prosimo, da tega API-ja ne kličete več kot 5-krat v eni uri in ne več kot 30-krat v enem dnevu.
Pridobite žeton računa, ki se uporablja v vseh API-jih.
URL:https://www.iammeter.com/api/v1/user/login
metoda:post
| št. | parameter | pripomba | primer |
|---|---|---|---|
| 1 | uporabniško ime | Uporabniško ime IAMMETER | test |
| 2 | geslo | geslo IAMMETER | 123456 |
Vrednost žetona bo uporabljena v vseh spodnjih API-jih.
{
"podatki": {
"id": 2025,
"žeton": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"uspešno": res,
"sporočilo": nič
}Ta žeton je mogoče prebrati tudi neposredno po prijavi v sistem.
Pridobite podatke o zadnjem nalaganju z zadevnim SN.
Prosimo, da tega API-ja ne kličete več kot 12-krat v eni uri.
Osnovno (podatki merilnika): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Napredno (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Metoda: DOBITI
Omejitev: ne zahtevajte tega API-ja več kot 288-krat na dan (5-minutni interval).
Razlika med osnovnim in naprednim:
Osnovno: brez PF (faktor moči)
Napredno: s PF (faktor moči)
| Ime | Vrsta | Primer | |
|---|---|---|---|
| Žeton | Vrvica | xxx | potrebno |
definicija vrednosti: napetost, tok, aktivna moč, uvožena Kwh, izvožena Kwh
{
"podatki": {
"vrednosti": [
[
230.220,
1.300,
119.000,
1766.590,
0,000
]
],
"lokalni čas": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"uspešno": res,
"sporočilo": nič
}definicija vrednosti: napetost, tok, aktivna moč,faktor moči,uvoženih Kwh, izvoženih Kwh
{
"podatki":{
"vrednosti":[
[
233,41,
0,718,
111,
0,66,
5724.85,
0
]
],
"lokalni čas":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"uspešno": res,
"sporočilo":nič
}Trije nizi vvrednotepredstavljajo fazo A, fazo B in fazo C.
Definicija elementa: napetost, tok, aktivna moč,faktor moči,uvoženih Kwh, izvoženih Kwh
{
"podatki": {
"vrednosti": [
[
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
]
],
"lokalni čas": "2020/8/28 15:30:48",
"gmtTime": "2020/8/28 5:30:48"
},
"uspešno": res,
"sporočilo": nič
}{
"podatki":{
"vrednosti":[
[//faza A
233,8 // napetost
0,03,//trenutno
4,//aktivna moč
0,57,//faktor moči
222,53,//uvoženih Kwh
0 //izvoženih Kwh
],
[//faza B
5,
0,
0,
0,
0,
0
],
[ //faza C
3.1,
0,
0,
0,
0,
0
]
],
"lokalni čas":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"uspešno": res,
"sporočilo":nič
}
Vrne zgodovinske podatke o nastavljenem intervalu in časovnem razponu.
Trenutni podatki so v intervalu 1 min. Na dan je 60*24=1440 podatkov. Če zahtevate zgodovinske podatke v intervalu 1 minute, lahko zahtevate le podatke za 1,39 (2000/1440) dni. Če pa zahtevate podatke v intervalu 5 minut, lahko zahtevate podatke za skoraj 7 dni.
Osnovno (podatkovnik merilnikov):https://www.iammeter.com/api/v1/site/meterdatalist/
**Napredno (meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Razlika med osnovnim in naprednim:
Osnovno: brez PF (faktor moči)
Napredno: s PF (faktor moči)
| Ime | Vrsta | Primer | |
|---|---|---|---|
| Žeton | Vrvica | xxx | potrebno |
| interval | število | 300 | obvezno, enota: sekunda |
| Začetni čas | vrvica | 2023-09-01 | potrebno |
| končni čas | vrvica | 2023-09-07 | potrebno |
Podatki: [napetost, tok, moč, uvoz energije, izvoz energije, UTC čas, lokalni čas]
{
"podatki": [
[
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"
]
],
"uspešno": res,
"sporočilo": nič
}{
"podatki": [
[
230,//napetost faze A
0,//trenutno
0,//aktivna moč
468,41,//uvoženih kWh
0,//izvoženih kWh
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"
]
],
"uspešno": res,
"sporočilo": nič
}{
"podatki":[
{ //prvi podatki
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"vrednosti":[
[ //faza A
235.2, // napetost
0,03,//trenutno
4,//aktivna moč
0,57,//faktor moči
210.21,//uvoz Kwh
0 //izvoženih Kwh
],
[//faza B
5,5,
0,
0,
0,
0,
0
],
[ //faza C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //drugi podatek
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"vrednosti":[
[
233,4,
0,03,
4,
0,57,
210,24,
0
],
[
5.4,
0,
0,
0,
0,
0
],
[
3.3,
0,
0,
0,
0,
0
]
]
},
{ //tretji podatek
"rtcTime":"2023/9/1 16:00:24",
"gmtTime":"2023/9/1 8:00:24",
"vrednosti":[
[
235,6,
0,03,
4,
0,57,
210,27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"uspešno": res,
"sporočilo":nič
}
Vrnite rezultat analize moči v določenem času.
Prosimo, da tega API-ja ne kličete več kot 5-krat v enem dnevu.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Metoda: dobiti
Omejitev: Prosimo, ne zahtevajte tega API-ja na SN več kot 5-krat na dan.
| Ime | Vrsta | Primer | |
|---|---|---|---|
sn |
Vrvica | xxx | potrebno |
Začetni čas |
Vrvica | 2023-09-01 | neobvezno |
končni čas |
Vrvica | 2023-09-07 | neobvezno |
Opomba:
povprečje: povprečni odčitek moči v tem časovnem območju.
povprečni dnevni čas: povprečni dnevni (8:00 do 20:00) odčitek moči v tem časovnem razponu.
minimum: odčitek najmanjše moči v tem časovnem območju.
maksimum: največji odčitek moči v tem časovnem območju.
{
"podatki": {
"začetni čas": "2023-09-01",
"konec": "2023-09-07",
"povprečje": 862,6,
"povprečni dnevni čas": 836,9,
"najmanj": 259,0,
"največ": 3999,0
},
"uspešno": res,
"sporočilo": nič
}Vrni rezultat analize moči zadnjih 7 dni.
Vrni rezultat analize moči določenega dne
Vrni status odklopa z obravnavanim SN v navedenem času.
Prosimo, da tega API-ja ne kličete več kot 5-krat v enem dnevu.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Metoda：Dobiti
Omejitev: Prosimo, ne zahtevajte tega API-ja na SN več kot 5-krat na dan.
| Ime | Vrsta | Primer | |
|---|---|---|---|
sn |
Vrvica | xxxx | potrebno |
Začetni čas |
Vrvica | 2023-09-01 | neobvezno |
končni čas |
Vrvica | 2023-09-07 | neobvezno |
interval(enota : minuta) |
številka | 5 | neobvezno |
Opomba:
V tem časovnem razponu je skupaj 10080 minut.
Skupni čas brez povezave je 906 minut v tem časovnem razponu.
Vrzel brez povezave, ki je večja od 5 minut, je navedena v matriki.
{
"podatki": {
"začetni čas": "2023-09-05",
"končni čas": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"seznam": [
{
"začetni čas": "2023/9/5 0:00:00",
"konec": "2023/9/5 15:06:14",
"trajanje": 906
}
]
},
"uspešno": res,
"sporočilo": nič
}Vrni rezultat analize brez povezave za navedeni dan
3-fazni merilnik energije WiFi
Uporabite 3-fazni števec električne energije tako, kot želite
Trifazni merilnik energije Wi-Fi
Enofazni merilnik energije Wi-Fi