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
Toto API lze otestovat online vZískání tokenu IAMMETER SwaggerUI
| 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}
Toto API lze otestovat online vIAMPERMETR SwaggerUI
Pokročilé (data metru2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Toto API lze otestovat online vIAMMETER SwaggerUI měřicí dataaIAMPERMETER SwaggerUI meterdata2
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)
| Jméno | Typ | Příklad | |
|---|---|---|---|
| Žeton | Tětiva | xxx | Požadované |
| čas_údajů | řetězec | 2025-6-16 | volitelný |
definice hodnot: napětí, proud, činný výkon, importované kWh, exportované kWh
{
„data“: {
„hodnoty“: [
[
230,220, //napětí
1,300, //proud
119,000, //činný výkon
1766,590, //importované kWh
0,000 //exportované kWh
]
],
„místní čas“: „28. 8. 2020 15:27:33“,
„gmtčas“: „28. 8. 2020 5:27:33“
},
„úspěšné“: true,
„zpráva“: null
}definice hodnot: napětí,proud,činný výkon,faktor síly,importované kWh, exportované kWh.
I když uznáváme, že umístění účiníku mezi činný výkon a importovanou energii není optimální, současný formát je již takto nastaven – mějte prosím na paměti toto uspořádání.
{
„data“:{
„hodnoty“:[
[
233,41, //napětí
0,718,//proud
111,//činný výkon
0,66,//účiník
5724,85, //importovaná energie
0 //exportovaná energie
]
],
„místní čas“: „2023/11/21 14:30:22“,
„gmtčas“: „2023/11/21 6:30:22“
},
„úspěšné“:true,
„zpráva“:null
}Tři pole vhodnotypředstavují fázi A, fázi B a fázi C.
definice hodnot: napětí, proud, činný výkon, importované kWh, exportované kWh
{
„data“: {
„hodnoty“: [
[
242,600,//napětí
1,000,//proud
216,000,//činný výkon
32354,600,//importovaná energie
0,000//exportovaná energie
],
[
242,600, 1,000, 1986,000, 30536,410, 17704,720
],
[
0,000, 0,000, 0,000, 0,000, 0,000
]
],
„místní čas“: „2020/8/28 15:30:48“,
„gmtTime“: „28. 8. 2020 5:30:48“
},
„úspěšné“: true,
„zpráva“: null
}Definice prvku: napětí, proud, činný výkon,faktor sílyimportované kWh, exportované kWh
{
„data“:{
„hodnoty“:[
[//fáze A 233,8,//napětí
0,03,//proud
4,//činný výkon
0,57,//účiník
222,53,//importované kWh
0 //exportované kWh
],
[//fáze B 5, 0, 0, 0, 0, 0
],
[ //fáze C 3,1, 0, 0, 0, 0, 0,
0
]
],
„místní čas“: „2023/11/21 14:39:36“,
„gmtčas“: „2023/11/21 6:39:36“
},
„úspěšné“:true,
„zpráva“:null
}
RTC (hodiny reálného času) je také parametrem v požadavku HTTP GET, jak je znázorněno níže:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16Tento požadavek vrátí nahranou hodnotu dat z měřiče nejblíže zadanému datu (16. 6. 2025), tj. nejbližšímu zaznamenanému časovému bodu.
Poznámka: Tato API jsou stejná jako v předchozí kapitole, pouze přidávají některé další parametry.
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)
Toto API lze otestovat online vIAMMETER SwaggerUI měřicí dataaIAMPERMETER SwaggerUI meterdata2
| Jméno | Typ | Příklad | |
|---|---|---|---|
| Žeton | Tětiva | xxx | Požadované |
| interval | číslo | 300 | požadováno, jednotka: sekunda |
| Doba spuštění | řetězec | 2023-09-01 | Požadované |
| čas ukončení | řetězec | 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“: „1. 9. 2023 0:00:22“,
„gmtTime“: „31. 8. 2023 16:00:22“,
„hodnoty“:[
[ //fáze A 235,2,//napětí 0,03,//proud 4,//činný výkon 0,57,//účiník 210,21,//import kWh
0 //export kWh
],
[//fáze B 5,5,
0,
0,
0,
0,
0,
0
],
[ //fáze C 3,3,
0,
0,
0,
0,
0,
0
]
]
},
{ //druhé údaje
„rtcTime“: „1. 9. 2023 8:00:49“,
„gmtTime“: „1. 9. 2023 0:00:49“,
„hodnoty“: [
[
233,4,
0,03,
4,
0,57,
210,24,
0
],
[
5,4,
0,
0,
0,
0,
0,
0,
0
],
[
3,3,
0,
0,
0,
0,
0,
0,
0
]
]
},
{ //třetí údaje
„rtcTime“: „1. 9. 2023 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,
0
],
[
3,4,
0,
0,
0,
0,
0,
0,
0
]
]
}
],
„úspěšné“:true,
„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
Metodazískat
Omezit: Prosím, nepožadujte toto API na SN více než 5krát denně.
| Jméno | 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ě.
| Jméno | 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
Vraťte nejnovější hodnotu všech elektroměrů na tomto účtu.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metoda：Dostat
Omezit: Zajistěte prosím, abyste na toto rozhraní API nevytvářeli požadavky častěji než jednou za 5 minut.
| Jméno | Typ | Příklad | |
|---|---|---|---|
| Žeton | Tětiva | xxx | Požadované |
{
"data":[
{
"sn":"DA2BED94",
"hodnoty":[
223,71,
1,74,
225,
14761,03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn":"B384789C",
"hodnoty":[
[
248,9,
13,9,
3356,
21228,
0,
nula,
nula
],
[
248,9,
13,9,
-2747,
8988,48,
18489,44,
nula,
nula
],
[
nula,
nula,
nula,
nula,
nula,
nula,
nula
],
[
248,9,
13,9,
-2747,
8988,48,
18489,44,
nula,
nula
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"674B1E5D",
"hodnoty":[
[
220,4,
1,86,
377,
5345,985,
20,565
],
[
220,4,
1,86,
377,
5367,715,
0,033
],
[
220,5,
1,86,
377,
5369,532,
0,033
]
],
"gmtTime":"22. 2. 2024 3:45:50"
},
{
"sn":"59C9AB8D",
"hodnoty":[
[
245,3,
6,5,
1604,
46055,7,
0,
nula,
nula
],
[
245,3,
6,5,
-910,
15726,73,
8956,56,
nula,
nula
],
[
nula,
nula,
nula,
nula,
nula,
nula,
nula
],
[
245,3,
6,5,
-910,
15726,73,
8956,56,
nula,
nula
]
],
"gmtTime":"22. 2. 2024 3:45:15"
},
{
"sn":"3FE34ABE",
"hodnoty":[
[
230,
15.9,
3650,1,
2704,35,
0,
49,99,
0,94
],
[
230,
-11,5,
-2650,1,
1411,31,
1722,35,
49,99,
0,94
],
[
230,
4.3,
1000,
1946,03,
0,
49,99,
0,94
]
],
"gmtTime":"22. 2. 2024 3:46:01"
}
],
"úspěšný":pravda,
"zpráva":null
}
Získejte hodinové/denní hodnoty kWh pro výrobu střídačů a výměnu sítě (jak exportované, tak importované)
URL：https://www.iammeter.com/api/v1/site/energyhistory/?Doba spuštění={2024-05-05}&čas ukončení={2024-07-07}&skupina vytvořená=&Žeton={2be6d1xxxxxxcc688}
Metodazískat
Omezit：
groupby = den: 90 dní data (90 pcs data)
groupby = hodina :7 dní data (168 pcs data)
| Jméno | Typ | Des | Příklad | |
|---|---|---|---|---|
| Žeton | Tětiva | token účtu | xxx | Požadované |
| místo_ID | číslo | ID místa | Požadované | |
| Doba spuštění | řetězec | čas začátku návratu tohoto rozhraní API | 2023-09-01 | Požadované |
| čas ukončení | řetězec | čas zastavení tohoto návratu API | 2023-09-07 | Požadované |
| skupinka | enum | vyberte interval návratových dat (hodina/den) | den/hodinu | Požadované |
ID_místa: Moje místa->Upravit
id_místa:1360
startTime=2024-05-05
konec=2024-05-07
skupina=den
{
"data": [{
"čas": "2024/5/5 0:00:00",
"výtěžek": 0,
"z mřížky": 9,62,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/6 0:00:00",
"výtěžek": 0,
"z mřížky": 9,16,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
}
],
"úspěšný": pravda,
"zpráva": null
}id_místa:2393
startTime=2024-05-05
konec=2024-05-07
skupina=den
{
"data": [{
"čas": "2024/5/5 0:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/6 0:00:00",
"výtěžek": 0,1,
"z mřížky": 0,22,
"toGrid": 7,15,
"speciální zatížení": 0,
"selfUse": 0
}
],
"úspěšný": pravda,
"zpráva": null
}id_místa:2393
startTime=2024-05-05
konec=2024-05-06
groupby=hodina
{
"data": [{
"čas": "2024/5/5 0:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 1:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 2:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 3:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 4:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 5:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 6:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 7:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 8:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 9:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 10:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 11:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 12:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 13:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 14:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 15:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 16:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 17:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 18:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 19:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 20:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 21:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 22:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
},
{
"čas": "2024/5/5 23:00:00",
"výtěžek": 0,
"z mřížky": 0,
"toGrid": 0,
"speciální zatížení": 0,
"selfUse": 0
}
],
"úspěšný": pravda,
"zpráva": null
}Jaké možnosti IAMMETER nabízí?
Jaký typ elektroměru nejlépe vyhovuje vašim potřebám?
Jak najít elektroměr s ohledem na vaše požadavky
Třífázový Wi-Fi měřič energie (WEM3080T)
Jednofázový Wi-Fi měřič energie (WEM3080)
Třífázový Wi-Fi měřič energie (WEM3046T)
Třífázový Wi-Fi měřič energie (WEM3050T)