Дом& gt;
Ресурсы& gt;
Документы& gt;
Как более эффективно использовать IAMMETER-облако с помощью API
Облако IAMMETER предоставляет некоторые API, и разработчик может использовать эти API для выполнения интересных задач, например интеграции данных IAMMETER в какую-либо стороннюю систему. Раньше мы только что открыли эти API для наших деловых партнеров и некоторых крупных клиентов, но теперь решили открыть их для всех наших клиентов.
Добро пожаловать, чтобы высказать свое мнение на нашем форуме.https://imeter.club
API нельзя посещать неограниченно, мы ограничим количество ежедневных вызовов для каждого API. Пожалуйста, не вызывайте API чаще.
Если количество вызовов превышает часовое или дневное ограничение, API ничего не вернет.
| Нет. | API | тип лимита | ежечасно | Ежедневно | описание |
|---|---|---|---|---|---|
| 1 | /Логин пользователя | IP | 5 | 30 | только один IP-адрес может вызывать этот API 5 раз в час |
| 2 | /сайт/meterdata/ | СН | 12 | только одному SN разрешено вызывать этот API 12 раз в час | |
| 3 | /сайт/powerAnaанализ | СН | 5 | одному SN разрешено вызывать этот API только 5 раз в день. | |
| 4 | /сайт/оффлайнАнализ | СН | 5 | одному SN разрешено вызывать этот API только 5 раз в день. |
Верните токен аккаунта. Токен будет использоваться практически во всех API.
Вам не нужно вызывать этот API, если вы не хотите обновить токен.Пожалуйста, не вызывайте этот API более 5 раз в час и не более 30 раз в день.
Получите токен учетной записи, который используется во всех API.
URL:https://www.iammeter.com/api/v1/user/login
Метод:почта
| Нет. | параметр | замечание | пример |
|---|---|---|---|
| 1 | имя пользователя | Имя пользователя IAMMETER | тест |
| 2 | пароль | пароль IAMMETER | 123456 |
Значение токена будет использоваться во всех API ниже.
{
«данные»: {
"идентификатор": 2025 год,
«токен»: «349dfxxxxxxac5169»,
«refreshToken»: «8adf75e5da10424985f3b83855133982»;
},
«успешный»: правда,
«сообщение»: ноль
}Этот токен также можно прочитать непосредственно после входа в систему.
Получите последние данные загрузки с соответствующим серийным номером.
Пожалуйста, не вызывайте этот API более 12 раз в час.
Базовый (данные счетчика): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Расширенный (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Метод: ПОЛУЧАТЬ
Лимит: пожалуйста, не запрашивайте этот API более 288 раз в день (с интервалом в 5 минут).
Разница между базовым и продвинутым:
Базовый: без PF (коэффициент мощности)
Расширенный: с PF (коэффициент мощности)
| Имя | Тип | Пример | |
|---|---|---|---|
| Токен | Нить | ххх | необходимый |
определение значений: напряжение, ток, активная мощность, импортированный кВтч, экспортированный кВтч.
{
«данные»: {
«ценности»: [
[
230.220,
1.300,
119.000,
1766.590,
0,000
]
],
«localTime»: «28.08.2020 15:27:33»,
«GMTTime»: «28.08.2020 5:27:33»;
},
«успешный»: правда,
«сообщение»: ноль
}определение значений: напряжение, ток, активная мощность,фактор силы,импортированный кВтч, экспортированный кВтч
{
"данные":{
"ценности":[
[
233,41,
0,718,
111,
0,66,
5724,85,
0
]
],
«localTime»: «2023/11/21 14:30:22»,
"GMTTime":"21 ноября 2023 г., 6:30:22"
},
"успешный": правда,
«сообщение»: ноль
}Три массива вценностипредставляют Фазу 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
]
],
«localTime»: «2020/8/28 15:30:48»,
«GMTTime»: «28.08.2020 5:30:48»;
},
«успешный»: правда,
«сообщение»: ноль
}{
"данные":{
"ценности":[
[//фаза А
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"
},
"успешный": правда,
«сообщение»: ноль
}
Возвращает исторические данные за заданный интервал и диапазон времени.
Мгновенные данные представлены с интервалом в 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 (коэффициент мощности)
| Имя | Тип | Пример | |
|---|---|---|---|
| Токен | Нить | ххх | необходимый |
| интервал | число | 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 // импортированных кВтч
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»;
]
],
«успешный»: правда,
«сообщение»: ноль
}{
"данные":[
{ //первые данные
«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
]
]
}
],
"успешный": правда,
«сообщение»: ноль
}
Вернуть результат анализа мощности за указанное время.
Пожалуйста, не вызывайте этот API более 5 раз в день.
URL-адрес: https://www.iammeter.com/api/v1/site/powerAnaанализ
Метод: получать
Лимит: Пожалуйста, не запрашивайте этот API для каждого серийного номера более 5 раз в день.
| Имя | Тип | Пример | |
|---|---|---|---|
зп |
Нить | ххх | необходимый |
время начала |
Нить | 2023-09-01 | необязательный |
время окончания |
Нить | 2023-09-07 | необязательный |
Примечание:
среднее: среднее значение мощности в этом временном диапазоне.
AverageDaytime: среднее значение мощности в дневное время (8:00–20:00) в этом временном диапазоне.
минимум: минимальное показание мощности в этом временном диапазоне.
максимум: максимальное показание мощности в этом временном диапазоне.
{
«данные»: {
«Время начала»: «01.09.2023»,
«Время окончания»: «07.09.2023»,
«средний»: 862,6,
«среднее дневное время»: 836,9,
"минимум": 259,0,
«максимум»: 3999,0
},
«успешный»: правда,
«сообщение»: ноль
}Возвращает результат анализа мощности за последние 7 дней.
Вернуть результат анализа мощности за указанный день
Вернуть статус разъединения с соответствующим SN в указанное время.
Пожалуйста, не вызывайте этот API более 5 раз в день.
URL-адрес：https://www.iammeter.com/api/v1/site/offlineAnaанализ
Метод：Получать
Лимит: Пожалуйста, не запрашивайте этот API для каждого серийного номера более 5 раз в день.
| Имя | Тип | Пример | |
|---|---|---|---|
зп |
Нить | хххх | необходимый |
время начала |
Нить | 2023-09-01 | необязательный |
время окончания |
Нить | 2023-09-07 | необязательный |
интервал(единица измерения: минута) |
Число | 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
}
]
},
«успешный»: правда,
«сообщение»: ноль
}Вернуть результат автономного анализа за указанный день
Возвращает последнее значение всех счетчиков энергии в этом аккаунте.
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-адрес: https://www.iammeter.com/api/v1/site/energyhistory/?время начала={2024-05-05}&время окончания={2024-07-07}&группа по=&Токен= {2be6d1xxxxxxcc688}
Метод: получать
Лимит：
groupby = день: данные за 90 дней (данные по 90 шт.)
groupby = час: данные за 7 дней (данные 168 шт.)
| Имя | Тип | Дес | Пример | |
|---|---|---|---|---|
| Токен | Нить | токен аккаунта | ххх | необходимый |
| идентификатор_места | число | идентификатор места | необходимый | |
| время начала | нить | время начала этого возврата API | 2023-09-01 | необходимый |
| время окончания | нить | время остановки этого возврата API | 2023-09-07 | необходимый |
| групповой | перечисление | выберите интервал возврата данных (час/день) | день/час | необходимый |
Place_ID: Мои места->Редактировать
Place_id: 1360
startTime=2024-05-05
endTime=2024-05-07
группировка=день
{
«данные»: [{
«время»: «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
группировка=день
{
«данные»: [{
«время»: «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
группировка=час
{
«данные»: [{
«время»: «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
}
],
«успешный»: правда,
«сообщение»: ноль
}Какие возможности предлагает IAMMETER?
Какой тип электросчетчика лучше всего соответствует вашим потребностям?
Как найти измеритель мощности с учетом ваших требований
Используйте 3-фазный счетчик энергии так, как вы предпочитаете
Трехфазный счетчик энергии Wi-Fi (WEM3080T)
Однофазный счетчик энергии Wi-Fi (WEM3080)
Трехфазный счетчик энергии Wi-Fi (WEM3046T)
Трехфазный счетчик энергии Wi-Fi (WEM3050T)