IAMMETER-cloud poskytuje některá rozhraní API a vývojář může tato rozhraní API použít k zajímavé práci, jako je integrace dat IAMMETER do systému třetí strany. Tato rozhraní API jsme již dříve otevřeli našim obchodním partnerům a některým velkým zákazníkům, ale rozhodli jsme se je nyní otevřít všem našim zákazníkům.
Vítejte a sdělte nám svůj názor na našem fóru.https://imeter.club
API nelze navštívit neomezeně, omezíme denní počet volání pro každé API. Prosím, nevolejte API častěji.
Pokud počet hovorů překročí hodinové nebo denní omezení, rozhraní API nic nevrátí.
| Ne. | API | typ limitu | hodinově | Denně | popis |
|---|---|---|---|---|---|
| 1 | /uživatelské přihlášení | ip | 5 | 30 | jedna IP může volat toto rozhraní API pouze 5krát za hodinu |
| 2 | /site/meterdata/ | SN | 12 | jedno SN může volat toto rozhraní API pouze 12krát za hodinu | |
| 3 | /site/powerAnalysis | SN | 5 | jednomu SN je povoleno volat toto rozhraní API pouze 5krát denně | |
| 4 | /site/offlineAnalýza | SN | 5 | jednomu SN je povoleno volat toto rozhraní API pouze 5krát denně |
Vraťte token účtu. Token bude použit téměř ve všech rozhraních API.
Toto rozhraní API nemusíte volat, pokud nechcete aktualizovat token.Prosím, nevolejte toto API více než 5krát za hodinu a ne více než 30krát za jeden den.
Získejte token účtu, který se používá ve všech rozhraních API.
URL:https://www.iammeter.com/api/v1/user/login
Metoda:pošta
| Ne. | parametr | Poznámka | příklad |
|---|---|---|---|
| 1 | uživatelské jméno | Uživatelské jméno IAMMETER | test |
| 2 | Heslo | heslo IAMMETER | 123456 |
Hodnota tokenu bude použita ve všech níže uvedených rozhraních API.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982";
},
"úspěšný": pravda,
"zpráva": null
}Tento token lze také číst přímo po přihlášení do systému.
Získejte poslední nahrávaná data s uznávaným SN.
Prosím, nevolejte toto API více než 12krát za hodinu.
Základní (měřená data): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Pokročilé (data metru2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Metoda: DOSTAT
Omezit: nepožadujte toto API více než 288krát denně (5 minut interval).
Rozdíl mezi základním a pokročilým:
Základní: bez PF (účiník)
Pokročilé: s PF (účiník)
| název | Typ | Příklad | |
|---|---|---|---|
| Žeton | Tětiva | xxx | Požadované |
definice hodnot: napětí,proud,činný výkon,importovaná Kwh, exportovaná Kwh
{
"data": {
"hodnoty": [
[
230,220,
1 300,
119 000,
1766,590,
0,000
]
],
"localTime": "28. 8. 2020 15:27:33",
"gmtTime": "28. 8. 2020 5:27:33"
},
"úspěšný": pravda,
"zpráva": null
}definice hodnot: napětí,proud,činný výkon,faktor síly,dovezené Kwh, vyvezené Kwh
{
"data":{
"hodnoty":[
[
233,41,
0,718,
111,
0,66,
5724,85,
0
]
],
"localTime":"21. 11. 2023 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"úspěšný":pravda,
"zpráva":null
}Tři pole vhodnotypředstavují fázi A, fázi B a fázi C.
Definice prvku: napětí, proud, činný výkon,faktor síly,dovezené Kwh, vyvezené Kwh
{
"data": {
"hodnoty": [
[
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
]
],
"localTime": "28. 8. 2020 15:30:48",
"gmtTime": "28. 8. 2020 5:30:48"
},
"úspěšný": pravda,
"zpráva": null
}{
"data":{
"hodnoty":[
[//fáze A
233,8,//napětí
0,03,//aktuální
4,//činný výkon
0,57,//účiník
222,53,//dovoz Kwh
0 //exportované Kwh
],
[//fáze B
5,
0,
0,
0,
0,
0
],
[ //fáze C
3.1,
0,
0,
0,
0,
0
]
],
"localTime":"21. 11. 2023 14:39:36",
"gmtTime":"21. 11. 2023 6:39:36"
},
"úspěšný":pravda,
"zpráva":null
}
Vraťte historická data o nastaveném intervalu a časovém rozsahu.
Okamžitá data jsou v intervalu 1 minuty. Denně je 60*24=1440 dat. Pokud požadujete historická data v intervalu 1 minuty, můžete požádat pouze o data 1,39 (2000/1440) dnů. Pokud však požadujete data v 5minutovém intervalu, můžete požádat o data téměř 7 dní.
Základní (meterdatalist):https://www.iammeter.com/api/v1/site/meterdatalist/
**Advanced(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Rozdíl mezi základním a pokročilým:
Základní: bez PF (účiník)
Pokročilé: s PF (účiník)
| název | Typ | Příklad | |
|---|---|---|---|
| Žeton | Tětiva | xxx | Požadované |
| interval | číslo | 300 | požadováno, jednotka: sekunda |
| Doba spuštění | tětiva | 2023-09-01 | Požadované |
| čas ukončení | tětiva | 2023-09-07 | Požadované |
Data: [napětí, proud, výkon, import energie, export energie, čas UTC, místní čas]
{
"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"
]
],
"úspěšný": pravda,
"zpráva": null
}{
"data": [
[
230,//fázeA napětí
0,//aktuální
0,//činný výkon
468,41,//dovezená kWh
0,//exportovaná kWh
230,//Fáze B
0,
0,
236,58,
290,77,
230,//Fáze 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"
]
],
"úspěšný": pravda,
"zpráva": null
}{
"data":[
{ //první data
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"hodnoty":[
[ //fáze A
235,2,//napětí
0,03,//aktuální
4,//činný výkon
0,57,//účiník
210,21,//dovoz Kwh
0 //exportované Kwh
],
[//fáze B
5,5,
0,
0,
0,
0,
0
],
[ //fáze C
3,3,
0,
0,
0,
0,
0
]
]
},
{ //sekundová data
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"hodnoty":[
[
233,4,
0,03,
4,
0,57,
210,24,
0
],
[
5.4,
0,
0,
0,
0,
0
],
[
3,3,
0,
0,
0,
0,
0
]
]
},
{ //třetí data
"rtcTime":"2023/9/1 16:00:24",
"gmtTime":"2023/9/1 8:00:24",
"hodnoty":[
[
235,6,
0,03,
4,
0,57,
210,27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3,4,
0,
0,
0,
0,
0
]
]
}
],
"úspěšný":pravda,
"zpráva":null
}
Vraťte výsledek analýzy výkonu v určeném čase.
Prosím, nevolejte toto API více než 5x za jeden den.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Metoda: dostat
Omezit: Prosím, nepožadujte toto API na SN více než 5krát denně.
| název | Typ | Příklad | |
|---|---|---|---|
sn |
Tětiva | xxx | Požadované |
Doba spuštění |
Tětiva | 2023-09-01 | volitelný |
čas ukončení |
Tětiva | 2023-09-07 | volitelný |
Poznámka:
průměr: průměrná hodnota výkonu během tohoto časového rozsahu.
averageDaytime: průměrný denní (8:00-20:00) odečet výkonu během tohoto časového rozsahu.
minimum: minimální odečet výkonu během tohoto časového rozsahu.
maximum: maximální odečet výkonu během tohoto časového rozsahu.
{
"data": {
"počáteční čas": "2023-09-01",
"endTime": "2023-09-07",
"průměr": 862,6,
"averageDaytime": 836,9,
"minimum": 259,0,
"maximum": 3999,0
},
"úspěšný": pravda,
"zpráva": null
}Vraťte výsledek analýzy výkonu za posledních 7 dní.
Vraťte výsledek analýzy výkonu ze zadaného dne
Vraťte stav odpojení s uvažovaným SN v určeném čase.
Prosím, nevolejte toto API více než 5x za jeden den.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Metoda：Dostat
Omezit: Prosím, nepožadujte toto API na SN více než 5krát denně.
| název | Typ | Příklad | |
|---|---|---|---|
sn |
Tětiva | xxxx | Požadované |
Doba spuštění |
Tětiva | 2023-09-01 | volitelný |
čas ukončení |
Tětiva | 2023-09-07 | volitelný |
interval(jednotka :minuta) |
Číslo | 5 | volitelný |
Poznámka:
V tomto časovém rozmezí je celkem 10080 minut.
Celková doba offline je v tomto časovém rozsahu 906 minut.
V poli je uvedena offline mezera, která je větší než 5 minut.
{
"data": {
"počáteční čas": "2023-09-05",
"endTime": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"seznam": [
{
"startTime": "2023/9/5 0:00:00",
"endTime": "2023/9/5 15:06:14",
"trvání": 906
}
]
},
"úspěšný": pravda,
"zpráva": null
}Vraťte výsledek offline analýzy zadaného dne
