IAMMETER-cloud giver nogle API'er, og udvikleren kan bruge disse API'er til at udføre noget interessant arbejde, såsom at integrere IAMMETERs data til et tredjepartssystem. Vi har lige åbnet disse API'er for vores forretningspartnere og nogle store kunder før, men besluttede at åbne dem for alle vores kunder nu.
Velkommen til at fortælle os om dine tanker på vores forum.https://imeter.club
API'en kan ikke besøges ubegrænset, vi vil begrænse det daglige opkaldstal for hver API. Venligst ikke kalde API'en oftere.
Hvis antallet af opkald overstiger time- eller daglig begrænsning, returnerer API'en intet.
| Ingen. | API | grænsetype | hver time | Daglige | beskrivelse |
|---|---|---|---|---|---|
| 1 | /bruger/login | ip | 5 | 30 | én IP må kun kalde dette api 5 gange i timen |
| 2 | /site/målerdata/ | SN | 12 | en SN må kun kalde dette api 12 gange i timen | |
| 3 | /site/powerAnalysis | SN | 5 | en SN må kun kalde dette api 5 gange dagligt | |
| 4 | /site/offlineAnalyse | SN | 5 | en SN må kun kalde dette api 5 gange dagligt |
Returner kontoens token. Tokenet vil blive brugt i næsten hele API'en.
Du behøver ikke kalde denne API, medmindre du vil opdatere tokenet.Ring venligst ikke denne API mere end 5 gange på en time og ikke mere end 30 gange på en dag.
Få tokenet for kontoen, som bruges i alle API'er.
URL:https://www.iammeter.com/api/v1/user/login
Metode:stolpe
| Ingen. | parameter | bemærkning | eksempel |
|---|---|---|---|
| 1 | brugernavn | Brugernavn på IAMMETER | prøve |
| 2 | adgangskode | adgangskode til IAMMETER | 123456 |
Tokenværdien vil blive brugt i alle nedenstående API'er.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"vellykket": sandt,
"meddelelse": null
}Dette token kan også læses direkte efter du har logget på systemet.
Hent de sidste uploaddata med den betragtede SN.
Ring venligst ikke denne API mere end 12 gange på en time.
Grundlæggende (målerdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Avanceret(målerdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Metode: FÅ
Begrænse: anmod venligst ikke om denne API mere end 288 gange hver dag (5 minutters interval).
Forskellen mellem grundlæggende og avanceret:
Grundlæggende: uden PF (effektfaktor)
Avanceret: med PF (Power factor)
| Navn | Type | Eksempel | |
|---|---|---|---|
| Polet | Snor | xxx | påkrævet |
værdier definition: spænding, strøm, aktiv effekt, importeret Kwh, eksporteret Kwh
{
"data": {
"værdier": [
[
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": sandt,
"meddelelse": null
}værdier definition: spænding, strøm, aktiv effekt,magtfaktor,importeret Kwh, eksporteret Kwh
{
"data":{
"værdier":[
[
233,41,
0,718,
111,
0,66,
5724.85,
0
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"succesfuld":sandt,
"besked":null
}De tre arrays iværdierrepræsenterer fase A, fase B og fase C.
Element definition: spænding, strøm, aktiv effekt,magtfaktor,importeret Kwh, eksporteret Kwh
{
"data": {
"værdier": [
[
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"
},
"vellykket": sandt,
"meddelelse": null
}{
"data":{
"værdier":[
[//fase A
233,8,//spænding
0,03,//strøm
4,//aktiv effekt
0,57,//effektfaktor
222,53,//importerede Kwh
0 //eksporteret 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"
},
"succesfuld":sandt,
"besked":null
}
Returner de historiske data på det indstillede interval og tidsinterval.
De øjeblikkelige data er i 1 min interval. Der er 60*24=1440 stykker data pr. dag. Hvis du anmoder om de historiske data i 1 min. interval, kan du kun anmode om data på 1,39(2000/1440) dage. Men hvis du anmoder om data i 5 minutters interval, kan du anmode om data på næsten 7 dage.
Grundlæggende (målerdataliste):https://www.iammeter.com/api/v1/site/meterdatalist/
**Avanceret(meterdataliste2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Forskellen mellem grundlæggende og avanceret:
Grundlæggende: uden PF (effektfaktor)
Avanceret: med PF (Power factor)
| Navn | Type | Eksempel | |
|---|---|---|---|
| Polet | Snor | xxx | påkrævet |
| interval | nummer | 300 | påkrævet, enhed: sekund |
| starttidspunkt | snor | 2023-09-01 | påkrævet |
| sluttid | snor | 2023-09-07 | påkrævet |
Data:[spænding, 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": sandt,
"meddelelse": null
}{
"data": [
[
230,//faseA spænding
0,//aktuel
0,//aktiv effekt
468,41,//importeret kWh
0,//eksporteret 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": sandt,
"meddelelse": null
}{
"data":[
{//første data
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"værdier":[
[ //fase A
235,2,//spænding
0,03,//strøm
4,//aktiv effekt
0,57,//effektfaktor
210,21,//import Kwh
0 //eksporteret 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",
"værdier":[
[
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ærdier":[
[
235,6,
0,03,
4,
0,57,
210,27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"succesfuld":sandt,
"besked":null
}
Returner effektanalyseresultatet inden for den angivne tid.
Ring venligst ikke denne API mere end 5 gange på en dag.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Metode: få
Begrænse: Anmod venligst ikke om denne API pr. SN mere end 5 gange hver dag.
| Navn | Type | Eksempel | |
|---|---|---|---|
sn |
Snor | xxx | påkrævet |
starttidspunkt |
Snor | 2023-09-01 | valgfri |
sluttid |
Snor | 2023-09-07 | valgfri |
Bemærk:
gennemsnit: gennemsnitlig effektaflæsning i dette tidsinterval.
gennemsnitlig dagtid: gennemsnitlig effektaflæsning i dagtimerne (8:00-20:00) i dette tidsinterval.
minimum: minimum effektaflæsning i dette tidsinterval.
maksimum: maksimal effektaflæsning i dette tidsinterval.
{
"data": {
"starttid": "2023-09-01",
"sluttidspunkt": "2023-09-07",
"gennemsnit": 862,6,
"gennemsnitlig dagtid": 836,9,
"minimum": 259,0,
"maksimum": 3999,0
},
"vellykket": sandt,
"meddelelse": null
}Returner effektanalyseresultatet for de sidste 7 dage.
Returner effektanalyseresultatet for den angivne dag
Returner afbrydelsesstatus med betragtet SN inden for det angivne tidspunkt.
Ring venligst ikke denne API mere end 5 gange på en dag.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Metode：Få
Begrænse: Anmod venligst ikke om denne API pr. SN mere end 5 gange hver dag.
| Navn | Type | Eksempel | |
|---|---|---|---|
sn |
Snor | xxxx | påkrævet |
starttidspunkt |
Snor | 2023-09-01 | valgfri |
sluttid |
Snor | 2023-09-07 | valgfri |
interval(enhed :minut) |
Nummer | 5 | valgfri |
Bemærk:
Der er i alt 10080 minutter i dette tidsinterval.
Den samlede offlinetid er 906 minutter i dette tidsinterval.
Offlinemellemrummet, der er større end 5 minutter, er angivet i arrayet.
{
"data": {
"starttid": "2023-09-05",
"sluttidspunkt": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"liste": [
{
"starttid": "2023/9/5 0:00:00",
"sluttid": "2023/9/5 15:06:14",
"varighed": 906
}
]
},
"vellykket": sandt,
"meddelelse": null
}Returner offlineanalyseresultatet for den angivne dag
