IAMMETER-cloud предоставя някои API и разработчикът може да използва тези API, за да извърши интересна работа, като например интегриране на данните на IAMMETER към система на трета страна. Току-що отворихме тези API за нашите бизнес партньори и някои големи клиенти преди, но решихме да ги отворим за всички наши клиенти сега.
Добре дошли да споделите с нас какво мислите в нашия форум.https://imeter.club
API не може да се посещава неограничено, ние ще ограничим дневния брой обаждания за всеки API. Моля, не се обаждайте на API по-често.
Ако броят на обажданията надвиши почасовото или дневното ограничение, API няма да върне нищо.
| Не. | API | тип ограничение | почасово | Ежедневно | описание |
|---|---|---|---|---|---|
| 1 | /потребителски вход | ip | 5 | 30 | само един IP може да извиква този api 5 пъти на час |
| 2 | /site/meterdata/ | SN | 12 | само един SN може да извиква този api 12 пъти на час | |
| 3 | /site/powerAnalysis | SN | 5 | само на един SN е позволено да извиква този api 5 пъти дневно | |
| 4 | /site/offlineAnalysis | SN | 5 | само на един SN е позволено да извиква този api 5 пъти дневно |
Върнете токена на акаунта. Токенът ще се използва в почти всички API.
Не е необходимо да извиквате този API, освен ако не искате да опресните токена.Моля, не се обаждайте на този API повече от 5 пъти за един час и не повече от 30 пъти за един ден.
Вземете токена на акаунта, който се използва във всички API.
URL:https://www.iammeter.com/api/v1/user/login
Метод:пост
Този API може да бъде тестван онлайн вIAMMETER SwaggerUI получаване на токен
| Не. | параметър | забележка | пример |
|---|---|---|---|
| 1 | потребителско име | Потребителско име на IAMMETER | тест |
| 2 | парола | парола на IAMMETER | 123456 |
Стойността на токена ще се използва във всички API по-долу.
{
"данни": {
"id": 2025,
"токен": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"успешно": вярно,
"съобщение": нула
}Този токен може да бъде прочетен и директно след като влезете в системата.
Вземете последните данни за качване със съответния SN.
Моля, не извиквайте този API повече от 12 пъти за един час.
Основен (метрични данни): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Този API може да бъде тестван онлайн вIAMPERМЕТЪР SwaggerUI
Разширени (метрични данни 2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Този API може да бъде тестван онлайн вIAMMETER SwaggerUI измервателни даннииIAMMETER SwaggerUI meterdata2
Метод: ВЗЕМЕТЕ
Лимит: моля, не изисквайте този API повече от 288 пъти всеки ден (интервал от 5 минути).
Разликата между основни и разширени:
Основен: без PF (фактор на мощността)
Разширено: с PF (фактор на мощността)
| Име | Тип | Пример | |
|---|---|---|---|
| Токен | низ | xxx | изисква се |
| време за реакция | низ | 2025-6-16 | по желание |
дефиниция на стойности: напрежение, ток, активна мощност, импортирани kWh, експортирани kWh
{
„данни“: {
„стойности“: [
[
230.220, //напрежение
1.300, //ток
119.000, //активна мощност
1766.590, //импортирани kWh
0.000 //експортирани kWh
]
],
„местноВреме“: „2020/8/28 15:27:33“,
„gmtВреме“: „2020/8/28 5:27:33“
},
„успешно“: true,
„съобщение“: null
}дефиниция на стойности: напрежение, ток, активна мощност,фактор на мощността,внесени kWh, изнесени kWh.
Въпреки че осъзнаваме, че поставянето на коефициента на мощност между активната мощност и внесената енергия не е оптимално, текущият формат вече е настроен по този начин – моля, имайте предвид това споразумение.
{
„данни“:{
„стойности“:[
[
233.41, //напрежение
0.718,//ток
111,//активна мощност
0.66,//коефициент на мощността
5724.85, //внесена енергия
0 //внесена енергия
]
],
„местноВреме“: „2023/11/21 14:30:22“,
„gmtВреме“: „2023/11/21 6:30:22“
},
„успешно“:вярно,
„съобщение“:нулево
}Трите масива встойностипредставляват фаза A, фаза B и фаза C.
дефиниция на стойности: напрежение, ток, активна мощност, импортирани kWh, експортирани kWh
{
„данни“: {
„стойности“: [
[
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
]
],
„местно време“: „2020/8/28 15:30:48“,
„gmtTime“: „2020/8/28 5:30:48“
},
„успешно“: вярно,
„съобщение“: null
}Определение на елемента: напрежение, ток, активна мощност,фактор на мощността,внесени kWh, изнесени kWh
{
„данни“:{
„стойности“:[
[//фаза A
233.8,//напрежение
0.03,//ток
4,//активна мощност
0.57,//фактор на мощността
222.53,//импортирани kWh
0 //експортирани kWh
],
[//фаза B 5,
0,
0,
0,
0,
0
],
[ //фаза C 3.1,
0,
0,
0,
0,
0,
0
]
],
„местно време“: „2023/11/21 14:39:36“,
„gmt време“: „2023/11/21 6:39:36“
},
„успешно“:вярно,
„съобщение“:нула
}
RTC (часовник в реално време) също е параметър в HTTP GET заявката, както е показано по-долу:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16Тази заявка ще върне качената стойност на данните от измервателния уред, най-близка до посочената дата (16.06.2025 г.), т.е. най-близката регистрирана времева точка.
Забележка: тези API са същите като в предишната глава, само че са добавени някои повече параметри.
Връща историческите данни за зададения интервал и времеви диапазон.
Моменталните данни са в интервал от 1 минута. Има 60*24=1440 данни на ден. Ако поискате исторически данни в интервал от 1 минута, можете да поискате данни само за 1,39 (2000/1440) дни. Но ако поискате данните в интервал от 5 минути, можете да поискате данните от близо 7 дни.
Основен (метричен списък):https://www.iammeter.com/api/v1/site/meterdatalist/
**Разширени(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Разликата между основни и разширени:
Основен: без PF (фактор на мощността)
Разширено: с PF (фактор на мощността)
Този API може да бъде тестван онлайн вIAMMETER SwaggerUI измервателни даннииIAMMETER SwaggerUI meterdata2
| Име | Тип | Пример | |
|---|---|---|---|
| Токен | низ | xxx | изисква се |
| интервал | номер | 300 | необходимо, единица: секунда |
| начален час | низ | 2023-09-01 | изисква се |
| крайно време | низ | 2023-09-07 | изисква се |
Данни: [напрежение, ток, мощност, внос на енергия, износ на енергия, UTC време, местно време]
{
"данни": [
[
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"
]
],
"успешно": вярно,
"съобщение": нула
}{
"данни": [
[
230,//фаза А напрежение
0,//ток
0,//активна мощност
468.41,//внесени kWh
0,//изнесени kWh
230, // Фаза Б
0,
0,
236.58,
290.77,
230, // Фаза 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"
]
],
"успешно": вярно,
"съобщение": нула
}{
„данни“:[
{ //първи данни
„rtcTime“: „01.09.2023 0:00:22“,
„gmtTime“: „31.08.2023 16:00:22“,
„стойности“:[
[ //фаза A 235.2,//напрежение 0.03,//ток 4,//активна мощност 0.57,//коефициент на мощност 210.21,//импорт kWh
0 //експорт kWh
],
[//фаза B 5.5,
0,
0,
0,
0,
0,
0
],
[ //фаза C 3.3,
0,
0,
0,
0,
0,
0
]
]
},
{ //втори данни
„rtcTime“: „1.9.2023 8:00:49“,
„gmtTime“: „1.9.2023 0:00:49“,
„стойности“: [
[
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
]
]
},
{ //трети данни
„rtcTime“: „1.9.2023 16:00:24“,
„gmtTime“: „2023/9/1 8:00:24“, „стойности“: [
[
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
]
]
}
],
„успешно“:true,
„съобщение“:null
}
Върнете резултата от анализа на мощността в определеното време.
Моля, не се обаждайте на този API повече от 5 пъти за един ден.
URL адрес: https://www.iammeter.com/api/v1/site/powerAnalysis
Метод: получавам
Лимит: Моля, не изисквайте този API за SN повече от 5 пъти всеки ден.
| Име | Тип | Пример | |
|---|---|---|---|
сн |
низ | xxx | изисква се |
начален час |
низ | 2023-09-01 | по желание |
крайно време |
низ | 2023-09-07 | по желание |
Забележка:
средно: средно отчитане на мощността през този времеви диапазон.
средно дневно време: средно дневно (8:00 сутринта-20:00 вечерта) отчитане на мощността през този времеви диапазон.
минимум: минимално отчитане на мощността през този времеви диапазон.
максимум: отчитане на максимална мощност през този времеви диапазон.
{
"данни": {
"начален час": "2023-09-01",
"крайно време": "2023-09-07",
"средно": 862.6,
"средно през деня": 836,9,
"минимум": 259.0,
"максимум": 3999.0
},
"успешно": вярно,
"съобщение": нула
}Връща резултата от анализа на мощността за последните 7 дни.
Върнете резултата от анализа на мощността за посочения ден
Върнете състоянието на прекъсване с разглеждания SN в определеното време.
Моля, не се обаждайте на този API повече от 5 пъти за един ден.
URL адрес：https://www.iammeter.com/api/v1/site/offlineAnalysis
Метод：Вземете
Лимит: Моля, не изисквайте този API за SN повече от 5 пъти всеки ден.
| Име | Тип | Пример | |
|---|---|---|---|
сн |
низ | xxxx | изисква се |
начален час |
низ | 2023-09-01 | по желание |
крайно време |
низ | 2023-09-07 | по желание |
интервал(единица:минута) |
Номер | 5 | по желание |
Забележка:
Има общо 10080 минути в този времеви диапазон.
Общото време офлайн е 906 минути в този времеви диапазон.
Офлайн интервалът, който е по-голям от 5 минути, е посочен в масива.
{
"данни": {
"начален час": "2023-09-05",
"крайно време": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"списък": [
{
"начален час": "2023/9/5 0:00:00",
"краен час": "2023/9/5 15:06:14",
"продължителност": 906
}
]
},
"успешно": вярно,
"съобщение": нула
}Връща резултата от офлайн анализа за посочения ден
Връща най-новата стойност на всички електромери в този акаунт.
URL адрес：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Метод：Вземете
Лимит: Моля, уверете се, че не правите заявки към този API по-често от веднъж на всеки 5 минути.
| Име | Тип | Пример | |
|---|---|---|---|
| Токен | низ | xxx | изисква се |
{
"данни":[
{
"sn": "DA2BED94",
"стойности":[
223.71,
1,74,
225,
14761.03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn": "B384789C",
"стойности":[
[
248.9,
13.9,
3356,
21228,
0,
нула,
нула
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
нула,
нула
],
[
нула,
нула,
нула,
нула,
нула,
нула,
нула
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
нула,
нула
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn": "674B1E5D",
"стойности":[
[
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":"2024/2/22 3:45:50"
},
{
"sn": "59C9AB8D",
"стойности":[
[
245.3,
6.5,
1604,
46055.7,
0,
нула,
нула
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
нула,
нула
],
[
нула,
нула,
нула,
нула,
нула,
нула,
нула
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
нула,
нула
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn": "3FE34ABE",
"стойности":[
[
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":"2024/2/22 3:46:01"
}
],
"успешен": вярно,
"съобщение":нулево
}
Извлечете почасовите/дневните стойности на kWh за генериране на инвертор и обмен на мрежата (както експортирани, така и импортирани)
URL адрес：https://www.iammeter.com/api/v1/site/energyhistory/?начален час={2024-05-05}&крайно време={2024-07-07}&Групирай по=&Токен={2be6d1xxxxxxcc688}
Метод: получавам
Лимит：
groupby = ден: 90 дни данни (90 бр данни)
groupby = час :7 дни данни (168 бр данни)
| Име | Тип | Дес | Пример | |
|---|---|---|---|---|
| Токен | низ | токен на сметката | xxx | изисква се |
| place_ID | номер | ID на мястото | изисква се | |
| начален час | низ | начален час на това връщане на API | 2023-09-01 | изисква се |
| крайно време | низ | време на спиране на това връщане на API | 2023-09-07 | изисква се |
| grouphy | изброяване | изберете интервал за връщане на данни (час/ден) | ден/час | изисква се |
Идентификатор на място: Моите места->Редактиране
place_id:1360
начален час=2024-05-05
крайно време=2024-05-07
групиране по=ден
{
"данни": [{
"час": "2024/5/5 0:00:00",
"доходност": 0,
"от мрежата": 9,62,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/6 0:00:00",
"доходност": 0,
"от мрежата": 9.16,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
}
],
"успешно": вярно,
"съобщение": нула
}place_id:2393
начален час=2024-05-05
крайно време=2024-05-07
групиране по=ден
{
"данни": [{
"час": "2024/5/5 0:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/6 0:00:00",
"доходност": 0,1,
"от мрежата": 0,22,
"toGrid": 7.15,
"специално натоварване": 0,
"selfUse": 0
}
],
"успешно": вярно,
"съобщение": нула
}place_id:2393
начален час=2024-05-05
крайно време=2024-05-06
групиране по=час
{
"данни": [{
"час": "2024/5/5 0:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 1:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 2:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 3:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 4:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 5:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 6:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 7:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 8:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 9:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 10:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 11:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 12:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 13:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 14:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 15:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 16:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 17:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 18:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 19:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 20:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 21:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 22:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
},
{
"час": "2024/5/5 23:00:00",
"доходност": 0,
"от мрежата": 0,
"toGrid": 0,
"специално натоварване": 0,
"selfUse": 0
}
],
"успешно": вярно,
"съобщение": нула
}API на WiFi измервателя на енергия
Какви възможности предлага IAMMETER?
Кой тип електромер отговаря най-добре на вашите нужди?
Как да намерите електромера по отношение на вашите изисквания
Използвайте трифазния електромер по начина, по който предпочитате
Трифазен Wi-Fi измервател на енергия (WEM3080T)
Еднофазен Wi-Fi измервател на енергия (WEM3080)
Трифазен Wi-Fi измервател на енергия (WEM3046T)
Трифазен Wi-Fi измервател на енергия (WEM3050T)