IAMMETER-molnet tillhandahåller några API:er, och utvecklaren kan använda dessa API:er för att göra en del intressant arbete, som att integrera IAMMETERs data till något tredjepartssystem. Vi har precis öppnat dessa API:er för våra affärspartners och några stora kunder tidigare, men beslutade att öppna dem för alla våra kunder nu.
Välkommen att berätta för oss dina tankar på vårt forum.https://imeter.club
API:t kan inte besökas obegränsat, vi kommer att begränsa antalet dagliga samtal för varje API. Ring inte API oftare.
Om antalet samtal överskrider tim- eller dagliga begränsningar kommer API:et att returnera ingenting.
| Nej. | API | gränstyp | varje timme | Dagligen | beskrivning |
|---|---|---|---|---|---|
| 1 | /användarnamn | ip | 5 | 30 | en IP får endast anropa denna api 5 gånger per timme |
| 2 | /site/meterdata/ | SN | 12 | ett SN får endast anropa detta api 12 gånger per timme | |
| 3 | /site/powerAnalysis | SN | 5 | en SN får endast anropa detta api 5 gånger dagligen | |
| 4 | /site/offlineAnalys | SN | 5 | en SN får endast anropa detta api 5 gånger dagligen |
Returnera token för kontot. Token kommer att användas i nästan alla API.
Du behöver inte anropa detta API om du inte vill uppdatera token.Anrop inte detta API mer än 5 gånger på en timme och inte mer än 30 gånger på en dag.
Få token för kontot som används i alla API:er.
URL:https://www.iammeter.com/api/v1/user/login
Metod:posta
| Nej. | parameter | anmärkning | exempel |
|---|---|---|---|
| 1 | Användarnamn | Användarnamn för IAMMETER | testa |
| 2 | Lösenord | lösenord för IAMMETER | 123456 |
Tokenvärdet kommer att användas i alla API:er nedan.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"framgångsrik": sant,
"meddelande": null
}Denna token kan också läsas direkt efter att du loggat in i systemet.
Få den senaste uppladdningsdatan med den angivna SN.
Ring inte detta API mer än 12 gånger på en timme.
Basic(meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Avancerat(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Metod: SKAFFA SIG
Begränsa: begär inte detta API mer än 288 gånger varje dag (5 minuters intervall).
Skillnaden mellan grundläggande och avancerad:
Basic: utan PF (effektfaktor)
Avancerat: med PF (effektfaktor)
| namn | Typ | Exempel | |
|---|---|---|---|
| Tecken | Sträng | xxx | nödvändig |
värdedefinition: spänning, ström, aktiv effekt, importerad Kwh, exporterad Kwh
{
"data": {
"värden": [
[
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"
},
"framgångsrik": sant,
"meddelande": null
}värdedefinition: spänning, ström, aktiv effekt,effektfaktor,importerad Kwh, exporterad Kwh
{
"data":{
"värden":[
[
233,41,
0,718,
111,
0,66,
5724.85,
0
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"framgångsrik":sant,
"meddelande":null
}De tre arrayerna ivärdenrepresenterar fas A, fas B och fas C.
Elementdefinition: spänning, ström, aktiv effekt,effektfaktor,importerad Kwh, exporterad Kwh
{
"data": {
"värden": [
[
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
]
],
"lokal tid": "2020/8/28 15:30:48",
"gmtTime": "2020/8/28 5:30:48"
},
"framgångsrik": sant,
"meddelande": null
}{
"data":{
"värden":[
[//fas A
233,8,//spänning
0,03,//ström
4,//aktiv effekt
0,57,//effektfaktor
222,53,//importerad Kwh
0 //exporterade Kwh
],
[//fas B
5,
0,
0,
0,
0,
0
],
[ //fas C
3.1,
0,
0,
0,
0,
0
]
],
"localTime":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"framgångsrik":sant,
"meddelande":null
}
Returnera historiska data för det inställda intervallet och tidsintervallet.
Omedelbar data är i 1 min intervall. Det finns 60*24=1440 databitar per dag. Om du begär historiska data i 1 min intervall kan du bara begära data på 1,39(2000/1440) dagar. Men om du begär data med 5 minuters intervall kan du begära data på nästan 7 dagar.
Grundläggande (mätdatalista):https://www.iammeter.com/api/v1/site/meterdatalist/
**Avancerat(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Skillnaden mellan grundläggande och avancerad:
Basic: utan PF (effektfaktor)
Avancerat: med PF (effektfaktor)
| namn | Typ | Exempel | |
|---|---|---|---|
| Tecken | Sträng | xxx | nödvändig |
| intervall | siffra | 300 | krävs, enhet: andra |
| starttid | sträng | 2023-09-01 | nödvändig |
| sluttid | sträng | 2023-09-07 | nödvändig |
Data:[spänning, ström, effekt, importenergi, exportenergi, 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"
]
],
"framgångsrik": sant,
"meddelande": null
}{
"data": [
[
230,//fasA spänning
0,//ström
0,//aktiv effekt
468,41,//importerad kWh
0,//exporterad kWh
230,//FasB
0,
0,
236,58,
290,77,
230,//Fas 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"
]
],
"framgångsrik": sant,
"meddelande": null
}{
"data":[
{//första data
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"värden":[
[ //fas A
235,2,//spänning
0,03,//ström
4,//aktiv effekt
0,57,//effektfaktor
210,21,//import Kwh
0 //exporterade Kwh
],
[//fas B
5,5,
0,
0,
0,
0,
0
],
[ //fas C
3.3,
0,
0,
0,
0,
0
]
]
},
{//second data
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"värden":[
[
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",
"värden":[
[
235,6,
0,03,
4,
0,57,
210,27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"framgångsrik":sant,
"meddelande":null
}
Returnera effektanalysresultatet inom angiven tid.
Ring inte detta API mer än 5 gånger på en dag.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Metod: skaffa sig
Begränsa: Begär inte detta API per SN mer än 5 gånger varje dag.
| namn | Typ | Exempel | |
|---|---|---|---|
sn |
Sträng | xxx | nödvändig |
starttid |
Sträng | 2023-09-01 | frivillig |
sluttid |
Sträng | 2023-09-07 | frivillig |
Notera:
medelvärde: medeleffektavläsning under detta tidsintervall.
genomsnittlig dagtid: genomsnittlig effektavläsning på dagtid (8:00–20:00) under detta tidsintervall.
minimum: lägsta effektavläsning under detta tidsintervall.
maximum: maximal effektavläsning under detta tidsintervall.
{
"data": {
"starttid": "2023-09-01",
"sluttid": "2023-09-07",
"medelvärde": 862,6,
"genomsnittlig dagtid": 836,9,
"minimum": 259,0,
"maximum": 3999,0
},
"framgångsrik": sant,
"meddelande": null
}Returnera effektanalysresultatet för de senaste 7 dagarna.
Returnera effektanalysresultatet för den angivna dagen
Återställ frånkopplingsstatus med ansett SN inom angiven tid.
Ring inte detta API mer än 5 gånger på en dag.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Metod：Skaffa sig
Begränsa: Begär inte detta API per SN mer än 5 gånger varje dag.
| namn | Typ | Exempel | |
|---|---|---|---|
sn |
Sträng | xxxx | nödvändig |
starttid |
Sträng | 2023-09-01 | frivillig |
sluttid |
Sträng | 2023-09-07 | frivillig |
intervall(enhet :minut) |
siffra | 5 | frivillig |
Notera:
Det finns totalt 10080 minuter inom detta tidsintervall.
Den totala offlinetiden är 906 minuter inom detta tidsintervall.
Offlinegapet som är större än 5 minuter listas i arrayen.
{
"data": {
"starttid": "2023-09-05",
"sluttid": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"lista": [
{
"starttid": "2023/9/5 0:00:00",
"sluttid": "2023/9/5 15:06:14",
"varaktighet": 906
}
]
},
"framgångsrik": sant,
"meddelande": null
}Returnera offlineanalysresultatet för den angivna dagen
