IAMMETER-cloud biedt een aantal API's, en de ontwikkelaar kan deze API's gebruiken om interessant werk te doen, zoals het integreren van de gegevens van IAMMETER in een systeem van derden. We hebben deze API's zojuist opengesteld voor onze zakelijke partners en enkele grote klanten, maar hebben besloten ze nu voor al onze klanten open te stellen.
Welkom om ons uw mening te laten weten op ons forum.https://imeter.club
De API is niet onbeperkt te bezoeken, we beperken het dagelijkse aantal oproepen per API. Roep de API niet vaker aan.
Als het aantal oproepen de uur- of daglimiet overschrijdt, retourneert de API niets.
| Nee. | API | soort limiet | per uur | Dagelijks | beschrijving |
|---|---|---|---|---|---|
| 1 | /gebruiker login | ik p | 5 | 30 | één IP mag deze API slechts 5 keer per uur aanroepen |
| 2 | /site/meterdata/ | SN | 12 | één SN mag deze API slechts 12 keer per uur aanroepen | |
| 3 | /site/powerAnalyse | SN | 5 | één SN mag deze API slechts 5 keer per dag aanroepen | |
| 4 | /site/offlineanalyse | SN | 5 | één SN mag deze API slechts 5 keer per dag aanroepen |
Retourneer het token van het account. Het token zal in bijna de hele API worden gebruikt.
U hoeft deze API niet aan te roepen, tenzij u het token wilt vernieuwen.Roep deze API niet vaker dan 5 keer per uur aan, en niet meer dan 30 keer per dag.
Haal het token op van het account dat in alle API's wordt gebruikt.
URL:https://www.iammeter.com/api/v1/user/login
Methode:na
| Nee. | parameter | opmerking | voorbeeld |
|---|---|---|---|
| 1 | gebruikersnaam | Gebruikersnaam van IAMMETER | test |
| 2 | wachtwoord | wachtwoord van IAMMETER | 123456 |
De tokenwaarde wordt in alle onderstaande API's gebruikt.
{
"gegevens": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"succesvol": waar,
"bericht": nul
}Deze token kan ook direct worden uitgelezen nadat u bent ingelogd in het systeem.
Haal de laatste uploadgegevens op met het betreffende SN.
Roep deze API niet vaker dan twaalf keer per uur aan.
Basis(metergegevens): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Geavanceerd(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Methode: KRIJGEN
Begrenzing: vraag deze API niet vaker dan 288 keer per dag aan (interval van 5 minuten).
Het verschil tussen basis en gevorderd:
Basis: zonder PF (machtsfactor)
Geavanceerd: met PF (machtsfactor)
| Naam | Type | Voorbeeld | |
|---|---|---|---|
| Token | Snaar | xxx | vereist |
waardendefinitie: spanning, stroom, actief vermogen, geïmporteerde kWh, geëxporteerde kWh
{
"gegevens": {
"waarden": [
[
230.220,
1.300,
119.000,
1766.590,
0.000
]
],
"lokale tijd": "28/8/2020 15:27:33",
"gmtTime": "28/8/2020 5:27:33"
},
"succesvol": waar,
"bericht": nul
}waardendefinitie: spanning, stroom, actief vermogen,krachtfactor,geïmporteerde kWh, geëxporteerde kWh
{
"gegevens":{
"waarden":[
[
233.41,
0,718,
111,
0,66,
5724.85,
0
]
],
"lokale tijd":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"succesvol":waar,
"bericht":null
}De drie arrays inwaardenvertegenwoordigen fase A, fase B en fase C.
Elementdefinitie: spanning, stroom, actief vermogen,krachtfactor,geïmporteerde kWh, geëxporteerde kWh
{
"gegevens": {
"waarden": [
[
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
]
],
"lokale tijd": "28/8/2020 15:30:48",
"gmtTime": "28/8/2020 5:30:48"
},
"succesvol": waar,
"bericht": nul
}{
"gegevens":{
"waarden":[
[//fase A
233,8,//spanning
0,03,//stroom
4,//actief vermogen
0,57,//vermogensfactor
222,53,//geïmporteerde kWh
0 //geëxporteerde kWh
],
[//fase B
5,
0,
0,
0,
0,
0
],
[ //fase C
3.1,
0,
0,
0,
0,
0
]
],
"lokale tijd":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"succesvol":waar,
"bericht":null
}
Retourneer de historische gegevens over het ingestelde interval en tijdsbereik.
De directe gegevens hebben een interval van 1 minuut. Er zijn 60*24=1440 gegevenseenheden per dag. Als u de historische gegevens opvraagt met een interval van 1 minuut, kunt u alleen de gegevens van 1,39 (2000/1440) dagen opvragen. Maar als u de gegevens met een interval van 5 minuten opvraagt, kunt u de gegevens van bijna 7 dagen opvragen.
Basis(meterdatalijst):https://www.iammeter.com/api/v1/site/meterdatalist/
**Geavanceerd(meterdatalijst2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Het verschil tussen basis en gevorderd:
Basis: zonder PF (machtsfactor)
Geavanceerd: met PF (machtsfactor)
| Naam | Type | Voorbeeld | |
|---|---|---|---|
| Token | Snaar | xxx | vereist |
| interval | nummer | 300 | vereist, eenheid: tweede |
| starttijd | snaar | 2023-09-01 | vereist |
| eindtijd | snaar | 2023-09-07 | vereist |
Gegevens: [spanning, stroom, vermogen, energie importeren, energie exporteren, UTC-tijd, lokale tijd]
{
"gegevens": [
[
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"
]
],
"succesvol": waar,
"bericht": nul
}{
"gegevens": [
[
230,//faseA-spanning
0,//huidig
0,//actief vermogen
468,41,//geïmporteerde kWh
0,//geëxporteerde 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"
]
],
"succesvol": waar,
"bericht": nul
}{
"gegevens":[
{//eerste gegevens
"rtcTijd":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"waarden":[
[ //fase A
235,2,//spanning
0,03,//stroom
4,//actief vermogen
0,57,//vermogensfactor
210,21,//import kWh
0 //geëxporteerde kWh
],
[//fase B
5,5,
0,
0,
0,
0,
0
],
[ //fase C
3.3,
0,
0,
0,
0,
0
]
]
},
{//tweede gegevens
"rtcTijd":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"waarden":[
[
233,4,
0,03,
4,
0,57,
210.24,
0
],
[
5.4,
0,
0,
0,
0,
0
],
[
3.3,
0,
0,
0,
0,
0
]
]
},
{//derde gegevens
"rtcTijd":"2023/9/1 16:00:24",
"gmtTime":"2023/9/1 8:00:24",
"waarden":[
[
235,6,
0,03,
4,
0,57,
210.27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"succesvol":waar,
"bericht":null
}
Retourneer het resultaat van de vermogensanalyse binnen de opgegeven tijd.
Roep deze API niet vaker dan vijf keer op één dag aan.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Methode: krijgen
Begrenzing: Vraag deze API per SN niet vaker dan 5 keer per dag aan.
| Naam | Type | Voorbeeld | |
|---|---|---|---|
sn |
Snaar | xxx | vereist |
starttijd |
Snaar | 2023-09-01 | optioneel |
eindtijd |
Snaar | 2023-09-07 | optioneel |
Opmerking:
gemiddelde: gemiddelde vermogenswaarde gedurende dit tijdsbereik.
gemiddelde dag: gemiddelde vermogensmeting overdag (8:00 - 20:00 uur) gedurende dit tijdsbereik.
minimum: minimaal gemeten vermogen gedurende dit tijdsbereik.
maximum: maximale vermogenswaarde gedurende dit tijdsbereik.
{
"gegevens": {
"starttijd": "2023-09-01",
"eindtijd": "07-09-2023",
"gemiddeld": 862,6,
"gemiddelde dagtijd": 836,9,
"minimaal": 259,0,
"maximum": 3999,0
},
"succesvol": waar,
"bericht": nul
}Retourneer het resultaat van de vermogensanalyse van de afgelopen 7 dagen.
Retourneer het resultaat van de vermogensanalyse van de opgegeven dag
Retourneer de ontkoppelingsstatus met de betreffende SN binnen de opgegeven tijd.
Roep deze API niet vaker dan vijf keer op één dag aan.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Methode：Krijgen
Begrenzing: Vraag deze API per SN niet vaker dan 5 keer per dag aan.
| Naam | Type | Voorbeeld | |
|---|---|---|---|
sn |
Snaar | xxx | vereist |
starttijd |
Snaar | 2023-09-01 | optioneel |
eindtijd |
Snaar | 2023-09-07 | optioneel |
interval(eenheid: minuut) |
Nummer | 5 | optioneel |
Opmerking:
Er zijn in totaal 10080 minuten in dit tijdsbereik.
De totale offline tijd is 906 minuten in dit tijdsbereik.
De offline kloof die groter is dan 5 minuten wordt vermeld in de array.
{
"gegevens": {
"starttijd": "2023-09-05",
"eindtijd": "2023-09-11",
"offlineAantal": 906,
"totaalaantal": 10080,
"lijst": [
{
"starttijd": "2023/9/5 0:00:00",
"eindtijd": "2023/9/5 15:06:14",
"duur": 906
}
]
},
"succesvol": waar,
"bericht": nul
}Retourneer het offline analyseresultaat van de opgegeven dag
