Как более эффективно использовать 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 ниже.

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

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

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

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

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

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

URL и метод

Базовый (данные счетчика): 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»;
    },
    «успешный»: правда,
    «сообщение»: ноль
}

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

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

{
    "данные":{
        "ценности":[
            [
                233,41,
                0,718,
                111,
                0,66,
                5724,85,
                0
            ]
        ],
        «localTime»: «2023/11/21 14:30:22»,
        "GMTTime":"21 ноября 2023 г., 6:30:22"
    },
    "успешный": правда,
    «сообщение»: ноль
}

Ответ: 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
            ]
        ],
        «localTime»: «2020/8/28 15:30:48»,
        «GMTTime»: «28.08.2020 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"
    },
    "успешный": правда,
    «сообщение»: ноль
}

Пример

Получить запись истории

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

• временной диапазон: последний месяц
• максимальная длина данных: 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 (коэффициент мощности)

Параметры

Ответ: однофазный –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

Ссылка

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

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

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