IAMMETER-skyen gir noen APIer, og utvikleren kan bruke disse APIene til å gjøre noe interessant arbeid, for eksempel å integrere dataene til IAMMETER til et tredjepartssystem. Vi åpnet nettopp disse APIene for våre forretningspartnere og noen store kunder før, men bestemte oss for å åpne dem for alle våre kunder nå.
Velkommen til å fortelle oss dine tanker på forumet vårt.https://imeter.club
API kan ikke besøkes ubegrenset, vi vil begrense det daglige antallet anrop for hver API. Ikke ring API-en oftere.
Hvis anropstallene overstiger time- eller dagligbegrensningen, vil API-en ikke returnere noe.
Nei. | API | grensetype | hver time | Daglig | beskrivelse |
---|---|---|---|---|---|
1 | /Brukerinnlogging | ip | 5 | 30 | én IP har kun lov til å ringe dette api 5 ganger i timen |
2 | /site/meterdata/ | SN | 12 | ett SN har kun lov til å ringe dette api 12 ganger i timen | |
3 | /side/powerAnalysis | SN | 5 | en SN får bare lov til å ringe dette api 5 ganger daglig | |
4 | /side/offlineAnalyse | SN | 5 | en SN får bare lov til å ringe dette api 5 ganger daglig |
Returner tokenet til kontoen. Tokenet vil bli brukt i nesten hele API-en.
Du trenger ikke å kalle denne API-en med mindre du vil oppdatere tokenet.Ikke ring denne API-en mer enn 5 ganger i løpet av en time, og ikke mer enn 30 ganger på en dag.
Få tokenet til kontoen som brukes i alle API-ene.
URL:https://www.iammeter.com/api/v1/user/login
Metode:post
Nei. | parameter | bemerke | eksempel |
---|---|---|---|
1 | brukernavn | Brukernavn til IAMMETER | test |
2 | passord | passordet til IAMMETER | 123456 |
Tokenverdien vil bli brukt i alle API-ene nedenfor.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"vellykket": sant,
"melding": null
}
Dette tokenet kan også leses direkte etter at du har logget på systemet.
Få de siste opplastingsdataene med den antatte SN.
Ikke ring denne API-en mer enn 12 ganger i løpet av en time.
Grunnleggende (målerdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Avansert(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Metode: FÅ
Grense: Vennligst ikke be om denne APIen mer enn 288 ganger hver dag (5 minutters intervall).
Forskjellen mellom grunnleggende og avansert:
Grunnleggende: uten PF (effektfaktor)
Avansert: med PF (effektfaktor)
Navn | Type | Eksempel | |
---|---|---|---|
Token | String | xxx | nødvendig |
verdidefinisjon: spenning, strøm, aktiv effekt, importert Kwh, eksportert Kwh
{
"data": {
"verdier": [
[
230.220,
1.300,
119 000,
1766.590,
0,000
]
],
"lokal tid": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"vellykket": sant,
"melding": null
}
verdidefinisjon: spenning, strøm, aktiv effekt,maktfaktor,importert Kwh, eksportert Kwh
{
"data":{
"verdier":[
[
233,41,
0,718,
111,
0,66,
5724,85,
0
]
],
"lokal tid":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"vellykket":true,
"melding":null
}
De tre matrisene iverdierrepresenterer fase A, fase B og fase C.
Elementdefinisjon: spenning, strøm, aktiv effekt,maktfaktor,importert Kwh, eksportert Kwh
{
"data": {
"verdier": [
[
242 600,
1000,
216 000,
32354.600,
0,000
],
[
242 600,
1000,
1986.000,
30536.410,
17704.720
],
[
0.000,
0.000,
0.000,
0.000,
0,000
]
],
"lokal tid": "2020/8/28 15:30:48",
"gmtTime": "2020/8/28 5:30:48"
},
"vellykket": sant,
"melding": null
}
{
"data":{
"verdier":[
[//fase A
233,8,//spenning
0,03,//strøm
4,//aktiv effekt
0,57,//effektfaktor
222,53,//importert Kwh
0 //eksportert Kwh
],
[//fase B
5,
0,
0,
0,
0,
0
],
[ //fase C
3.1,
0,
0,
0,
0,
0
]
],
"lokal tid":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"vellykket":true,
"melding":null
}
Returner de historiske dataene for det angitte intervallet og tidsområdet.
Umiddelbar data er i 1 min intervall. Det er 60*24=1440 databiter per dag. Hvis du ber om historiske data i intervaller på 1 min, kan du bare be om data på 1,39 (2000/1440) dager. Men hvis du ber om dataene innen 5 minutters intervall, kan du be om dataene på nesten 7 dager.
Grunnleggende (meterdataliste):https://www.iammeter.com/api/v1/site/meterdatalist/
**Avansert(meterdataliste2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Forskjellen mellom grunnleggende og avansert:
Grunnleggende: uten PF (effektfaktor)
Avansert: med PF (effektfaktor)
Navn | Type | Eksempel | |
---|---|---|---|
Token | String | xxx | nødvendig |
intervall | Antall | 300 | nødvendig, enhet: sekund |
starttid | streng | 2023-09-01 | nødvendig |
sluttid | streng | 2023-09-07 | nødvendig |
Data:[spenning, strøm, strøm, import energi, eksport energi, utc tid, lokal tid]
{
"data": [
[
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"
]
],
"vellykket": sant,
"melding": null
}
{
"data": [
[
230,//faseA spenning
0,//gjeldende
0,//aktiv effekt
468,41,//importert kWh
0,//eksportert kWh
230,//FaseB
0,
0,
236,58,
290,77,
230,//Fase 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"
]
],
"vellykket": sant,
"melding": null
}
{
"data":[
{//første data
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"verdier":[
[ //fase A
235,2,//spenning
0,03,//strøm
4,//aktiv effekt
0,57,//effektfaktor
210,21,//import Kwh
0 //eksportert Kwh
],
[//fase B
5,5,
0,
0,
0,
0,
0
],
[ //fase C
3.3,
0,
0,
0,
0,
0
]
]
},
{//sekund data
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"verdier":[
[
233,4,
0,03,
4,
0,57,
210,24,
0
],
[
5.4,
0,
0,
0,
0,
0
],
[
3.3,
0,
0,
0,
0,
0
]
]
},
{//tredje data
"rtcTime":"2023/9/1 16:00:24",
"gmtTime":"2023/9/1 8:00:24",
"verdier":[
[
235,6,
0,03,
4,
0,57,
210,27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"vellykket":true,
"melding":null
}
Returner effektanalyseresultatet innen angitt tid.
Ikke ring denne API-en mer enn 5 ganger på en dag.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Metode: få
Grense: Vennligst ikke be om denne APIen per SN mer enn 5 ganger hver dag.
Navn | Type | Eksempel | |
---|---|---|---|
sn |
String | xxx | nødvendig |
starttid |
String | 2023-09-01 | valgfri |
sluttid |
String | 2023-09-07 | valgfri |
Merk:
gjennomsnitt: gjennomsnittlig effektavlesning i løpet av denne tidsperioden.
gjennomsnittlig dagtid: gjennomsnittlig strømavlesning på dagtid (08:00–20:00) i løpet av denne tidsperioden.
minimum: minimum effektavlesning i løpet av dette tidsrommet.
maksimum: maksimal effektavlesning i løpet av dette tidsrommet.
{
"data": {
"starttid": "2023-09-01",
"sluttid": "2023-09-07",
"gjennomsnittlig": 862,6,
"gjennomsnittlig dagtid": 836,9,
"minimum": 259,0,
"maksimum": 3999,0
},
"vellykket": sant,
"melding": null
}
Returner effektanalyseresultatet for de siste 7 dagene.
Returner effektanalyseresultatet for den angitte dagen
Returner frakoblingsstatusen med antatt SN i angitt tid.
Ikke ring denne API-en mer enn 5 ganger på en dag.
URL:https://www.iammeter.com/api/v1/site/offlineAnalysis
Metode:Få
Grense: Vennligst ikke be om denne APIen per SN mer enn 5 ganger hver dag.
Navn | Type | Eksempel | |
---|---|---|---|
sn |
String | xxxx | nødvendig |
starttid |
String | 2023-09-01 | valgfri |
sluttid |
String | 2023-09-07 | valgfri |
intervall (enhet :minutt) |
Antall | 5 | valgfri |
Merk:
Det er totalt 10080 minutter i denne tidsperioden.
Den totale frakoblede tiden er 906 minutter i denne tidsperioden.
Frakoblet gap som er større enn 5 minutter er oppført i matrisen.
{
"data": {
"starttid": "2023-09-05",
"sluttid": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"liste": [
{
"starttid": "2023/9/5 0:00:00",
"sluttid": "2023/9/5 15:06:14",
"varighet": 906
}
]
},
"vellykket": sant,
"melding": null
}
Returner frakoblet analyseresultat for den angitte dagen