Как более эффективно использовать IAMMETER-облако с помощью API

помещение

Облако IAMMETER предоставляет некоторые API, и разработчик может использовать эти API для выполнения интересных задач, например интеграции данных IAMMETER в какую-либо стороннюю систему. Раньше мы только что открыли эти API для наших деловых партнеров и некоторых крупных клиентов, но теперь решили открыть их для всех наших клиентов.

Добро пожаловать, чтобы высказать свое мнение на нашем форуме.https://imeter.club

Ограничение на API

API нельзя посещать неограниченно, мы ограничим количество ежедневных вызовов для каждого API. Пожалуйста, не вызывайте API чаще.

Если количество вызовов превышает часовое или дневное ограничение, API ничего не вернет.

Учетная запись: получите токен учетной записи.

Верните токен аккаунта. Токен будет использоваться практически во всех API.

Вам не нужно вызывать этот API, если вы не хотите обновить токен.Пожалуйста, не вызывайте этот API более 5 раз в час и не более 30 раз в день.

URL и метод

Получите токен учетной записи, который используется во всех API.

URL:https://www.iammeter.com/api/v1/user/login

Метод:почта

Этот API можно протестировать онлайн вIAMMETER SwaggerUI получить токен

Данные

Ответ

Значение токена будет использоваться во всех API ниже.

{
    «данные»: {
        "идентификатор": 2025 год,
        «токен»: «349dfxxxxxxac5169»,
        «refreshToken»: «8adf75e5da10424985f3b83855133982»;
    },
    «успешный»: правда,
    «сообщение»: ноль
}

Получите токен напрямую из веб-системы

Этот токен также можно прочитать непосредственно после входа в систему.

Energy Meter: получайте последние данные загрузки и время UTC.

Получите последние данные загрузки с соответствующим серийным номером.

Пожалуйста, не вызывайте этот API более 12 раз в час.

URL и метод

Базовый (данные счетчика): https://www.iammeter.com/api/v1/site/meterdata/{sn}

Этот API можно протестировать онлайн вIAMMETER SwaggerUI

Расширенный (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}

Этот API можно протестировать онлайн вДанные счетчика IAMMETER SwaggerUIиIAMMETER SwaggerUI meterdata2

Метод: ПОЛУЧАТЬ

Лимит: пожалуйста, не запрашивайте этот API более 288 раз в день (с интервалом в 5 минут).

Разница между базовым и продвинутым:

Базовый: без PF (коэффициент мощности)

Расширенный: с PF (коэффициент мощности)

Параметры

Ответ: однофазные данные счетчика (без коэффициента мощности)

определение значений: напряжение, ток, активная мощность, импортированный кВтч, экспортированный кВтч.

{
"data": {
"values": [
[
230.220, //напряжение
1.300, //ток
119.000, //активная мощность
1766.590, //импортированные кВт·ч
0.000 //экспортированные кВт·ч
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"successful": true,
"message": null
}

Ответ: однофазный -meterdata2 (с коэффициентом мощности)

определение значений: напряжение, ток, активная мощность,фактор силы,импортированные кВтч, экспортированные кВтч.

Хотя мы признаем, что размещение коэффициента мощности между активной мощностью и импортируемой энергией не является оптимальным, текущий формат уже настроен таким образом — пожалуйста, учтите эту договоренность.

{
"data":{
"values":[
[
233.41, //напряжение
0.718, //ток
111, //активная мощность
0.66, //коэффициент мощности
5724.85, //импортированная энергия
0 //экспортированная энергия 
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"successful":true,
"message":null
}

Ответ: 3-фазные данные счетчика (без коэффициента мощности)

Три массива вценностипредставляют Фазу A, Фазу B и Фазу C.

определение значений: напряжение, ток, активная мощность, импортированный кВтч, экспортированный кВтч.

{
"данные": {
"значения": [
[
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"
},
"успешно": правда,
"сообщение": ноль
}

Ответ: 3 фазы -meterdata2 (с коэффициентом мощности)

Определение элемента: напряжение, ток, активная мощность,фактор силы,импортированный кВтч, экспортированный кВтч

{
    "данные":{
        "ценности":[
            [//фаза А
                233,8 // напряжение
                0,03,//ток
                4,//активная мощность
                0,57,//коэффициент мощности
                222,53, // импортированный кВтч
                0 //экспортировано кВтч
            ],
            [//фаза Б
                5,
                0,
                0,
                0,
                0,
                0
            ],
            [ //фаза C
                3.1,
                0,
                0,
                0,
                0,
                0
            ]
        ],
        «localTime»: «21.11.2023 14:39:36»,
        "GMTTime":"21 ноября 2023 г., 6:39:36"
    },
    "успешный": правда,
    «сообщение»: ноль
}

Пример (получить последнее загруженное значение)

Пример (получить значение около определенного времени RTC)

RTC (часы реального времени) также являются параметром в HTTP-запросе GET, как показано ниже:

https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16

Этот запрос вернет загруженное значение данных счетчика, наиболее близкое к указанной дате (16.06.2025), то есть к ближайшей зафиксированной точке времени.

Energy Meter: получите запись истории

Примечание: эти API такие же, как в предыдущей главе, только добавлены некоторые дополнительные параметры.

Возвращает исторические данные за заданный интервал и диапазон времени.

• временной диапазон: последний месяц
• максимальная длина данных: 2000 штук

Мгновенные данные представлены с интервалом в 1 минуту. В день поступает 60*24=1440 фрагментов данных. Если вы запрашиваете исторические данные с интервалом в 1 минуту, вы можете запросить данные только за 1,39 (2000/1440) дней. Но если вы запрашиваете данные с интервалом в 5 минут, вы можете запросить данные почти за 7 дней.

URL и метод

Базовый (список счетчиков): 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

Параметры

Ответ: однофазный –meterdatalist

Данные: [напряжение, ток, мощность, импорт энергии, экспорт энергии, время 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»;
        ]
    ],
    «успешный»: правда,
    «сообщение»: ноль
}

Ответ: три фазы –meterdatalist

{
    «данные»: [
        [
            230,//напряжение фазы А
            0,//ток
            0,//активная мощность
            468,41 // импортированных кВтч
            0,//экспортировано кВтч
            230,//Фаза Б
            0,
            0,
            236,58,
            290,77,
            230,//Фаза С
            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»;
        ]
    ],
    «успешный»: правда,
    «сообщение»: ноль
}

Ответ: три фазы —meterdatalist2

{
    "данные":[
        { //первые данные
            «rtcTime»: «1 сентября 2023 0:00:22»,
            «GMTTime»: «2023/8/31 16:00:22»,
            "ценности":[
                [ //фаза А
                    235,2,//напряжение
                    0,03,//ток
                    4,//активная мощность
                    0,57,//коэффициент мощности
                    210.21,//импорт кВтч
                    0 //экспортировано кВтч
                ],
                [//фаза Б
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [ //фаза C
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { //вторые данные
            «rtcTime»: «1 сентября 2023 8:00:49»,
            «gmtTime»: «1 сентября 2023 0:00:49»,
            "ценности":[
                [
                    233,4,
                    0,03,
                    4,
                    0,57,
                    210.24,
                    0
                ],
                [
                    5.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { //третьи данные
            «rtcTime»: «2023/9/1 16:00:24»,
            «GMTTime»: «1 сентября 2023 8:00:24»,
            "ценности":[
                [
                    235,6,
                    0,03,
                    4,
                    0,57,
                    210,27,
                    0
                ],
                [
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        }
    ],
    "успешный": правда,
    «сообщение»: ноль
}

Пример

https://www.iammeter.com/api/v1/Site/MeterDataList/{yourSN}?token={yourToken}&startTime=2023-09-01&endTime=2023-09-07&interval=300

Счетчик энергии: анализ показаний мощности

Вернуть результат анализа мощности за указанное время.

Пожалуйста, не вызывайте этот API более 5 раз в день.

URL и метод

URL: https://www.iammeter.com/api/v1/site/powerAnaанализ

Метод: ПОЛУЧАТЬ

Лимит: Пожалуйста, не запрашивайте этот API для каждого серийного номера более 5 раз в день.

Параметры

Примечание:

1. Максимальный диапазон времени составляет 7 дней в последнем месяце.
2. Параметр времени является необязательным, если вы не используете этот параметр, API вернет результат за последние 7 дней.

Ответ

среднее: среднее значение мощности в этом временном диапазоне.

AverageDaytime: среднее значение мощности в дневное время (8:00–20:00) в этом временном диапазоне.

минимум: минимальное показание мощности в этом временном диапазоне.

максимум: максимальное показание мощности в этом временном диапазоне.

{
    «данные»: {
        «Время начала»: «01.09.2023»,
        «Время окончания»: «07.09.2023»,
        «средний»: 862,6,
        «среднее дневное время»: 836,9,
        "минимум": 259,0,
        «максимум»: 3999,0
    },
    «успешный»: правда,
    «сообщение»: ноль
}

Пример

Возвращает результат анализа мощности за последние 7 дней.

Вернуть результат анализа мощности за указанный день

https://www.iammeter.com/api/v1/site/powerAnaанализ?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

Счетчик энергии: автономный анализ состояния

Вернуть статус разъединения с соответствующим SN в указанное время.

Пожалуйста, не вызывайте этот API более 5 раз в день.

URL и метод

URL：https://www.iammeter.com/api/v1/site/offlineAnaанализ

Метод：Получать

Лимит: Пожалуйста, не запрашивайте этот API для каждого серийного номера более 5 раз в день.

Параметры

Примечание:

1. Максимальный диапазон времени составляет 7 дней в последнем месяце.
2. Параметр времени является необязательным, если вы не используете этот параметр, API вернет результат за последние 7 дней.
3. Если вы не укажете интервал, значение по умолчанию составляет 5 минут.

Ответ

Всего в этом временном диапазоне 10080 минут.

Общее время автономной работы составляет 906 минут в этом временном диапазоне.

В массиве указан перерыв в автономном режиме, превышающий 5 минут.

{
    «данные»: {
        «Время начала»: «05.09.2023»,
        «Время окончания»: «11 сентября 2023 г.»,
        «offlineCount»: 906,
        «TotalCount»: 10080,
        "список": [
            {
                «Время начала»: «2023/9/5 0:00:00»,
                «endTime»: «2023/9/5 15:06:14»,
                «продолжительность»: 906
            }
        ]
    },
    «успешный»: правда,
    «сообщение»: ноль
}

Пример

Вернуть результат автономного анализа за указанный день

https://www.iammeter.com/api/v1/site/offlineAnaанализ?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

Учетная запись: получение последних данных со всех счетчиков энергии в одной учетной записи.

Возвращает последнее значение всех счетчиков энергии в этом аккаунте.

URL и метод

URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx

Метод：Получать

Лимит: Убедитесь, что вы не отправляете запросы к этому API чаще, чем раз в 5 минут.

Параметры

Ответ

{
    "данные":[
        {
            «сн»: «DA2BED94»,
            "ценности":[
                223,71,
                1,74,
                225,
                14761.03,
                0
            ],
            "GMTTime":"22 февраля 2024 г., 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»;
        },
        {
            «сн»: «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":"22 февраля 2024 г., 3:45:50"
        },
        {
            «сн»: «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":"22 февраля 2024 г., 3:46:01"
        }
    ],
    "успешный": правда,
    «сообщение»: ноль
}

Пример

Место: возврат почасовых или ежедневных данных о кВтч для каждого типа использования.

Получите почасовые/дневные значения кВтч для генерации инвертором и обмена в сети (как экспортированные, так и импортированные)

URL и метод

URL: https://www.iammeter.com/api/v1/site/energyhistory/?время начала={2024-05-05}&время окончания={2024-07-07}&группа по=&Токен= {2be6d1xxxxxxcc688}

Метод: ПОЛУЧАТЬ

Лимит：

groupby = день: данные за 90 дней (данные по 90 шт.)

groupby = час: данные за 7 дней (данные 168 шт.)

Параметры

идентификатор_места: Мои места->Редактировать

Ответ: однофазный

Place_id: 1360

startTime=2024-05-05

endTime=2024-05-07

группировка=день

https://www.iammeter.com/api/v1/site/energyhistory/1360?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
	«данные»: [{
			«время»: «2024/5/5 0:00:00»,
			«Доходность»: 0,
			«из сетки»: 9,62,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/6 0:00:00»,
			«Доходность»: 0,
			«из сетки»: 9.16,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		}
	],
	«успешный»: правда,
	«сообщение»: ноль
}

Ответ: трехфазный

Place_id: 2393

startTime=2024-05-05

endTime=2024-05-07

группировка=день

https://www.iammeter.com/api/v1/site/energyhistory/2393?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
	«данные»: [{
			«время»: «2024/5/5 0:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/6 0:00:00»,
			«Выход»: 0,1,
			«из сетки»: 0,22,
			«toGrid»: 7.15,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		}
	],
	«успешный»: правда,
	«сообщение»: ноль
}

Place_id: 2393

startTime=2024-05-05

endTime=2024-05-06

группировка=час

https://www.iammeter.com/api/v1/site/energyhistory/2393?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
	«данные»: [{
			«время»: «2024/5/5 0:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 1:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 2:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 3:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 4:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 5:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 6:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 7:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 8:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 9:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 10:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 11:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 12:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 13:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 14:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 15:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 16:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 17:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 18:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 19:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 20:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 21:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 22:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		},
		{
			«время»: «2024/5/5 23:00:00»,
			«Доходность»: 0,
			«из сетки»: 0,
			«toGrid»: 0,
			«Специальная нагрузка»: 0,
			«Самоиспользование»: 0
		}
	],
	«успешный»: правда,
	«сообщение»: ноль
}

Ссылка

API счетчика энергии Wi-Fi

Какие возможности предлагает IAMMETER?

Какой тип электросчетчика лучше всего соответствует вашим потребностям?

Как найти измеритель мощности с учетом ваших требований

Используйте 3-фазный счетчик энергии так, как вы предпочитаете

3-х фазный счетчик энергии Wi-Fi