API для сервера

• Описание API для доступа к серверу

С помощью API инструмента можно отправить запрос на сервер и получить минутные или часовые данные за определенный интервал. Для использования API вашему приложению или веб-сайту необходимо отправить на сервер соответствующий HTTP-запрос. Запросы можно отсылать методом GET или POST. В ответ на запрос сервер возвращает HTTP-сообщение, в теле которого содержится результат обработки. Возвращаемые сервером результаты представлены в формате JSON.

Для работы с API необходим API key, который можно получить на странице профиля в smart-MAC Dashboard.

Данная функция доступна для лицензии БИЗНЕС.

Основные возможности и ограничения:

• В ответ на запрос приходят часовые данные за выбранный период.
• Максимальный интервал минутных данных один месяц, часовые без ограничений.
• При неправильно заданном интервале, интервал будет максимальный, от даты окончания (data2).
  
• При отсутствии в запросе date1 и date2, будут получены данные за один последний час. Последний час - это предыдущий текущему. Если данные отсутствуют, запрос вернет пустой массив.
• Дата отправляется в GMT в UNIX формате, с точностью до секунд.
• При отсутствии date1 будет выбран максимальный интервал от date2.
• Запросы можно отправлять не чаще, чем один раз в минуту.

Формат GET запроса для получения данных с сервера

https://dash.smart-maic.com/api?devid=[ИД устройства]&date1=[начало периода]&date2=[окончание периода]&period=[minute или hour]&apikey=[API key пользователя]

Формат POST запроса для получения данных с сервера

Адрес запроса: https://dash.smart-maic.com/api
Параметры запроса:
devid=[ИД устройства]    *) обязательный параметр
date1=[начало периода]
date2=[окончание периода]
period=[minute или hour]
apikey=[API key пользователя]    *) обязательный параметр

Пример GET запроса на сервер. Смотреть »

https://dash.smart-maic.com/api?devid=1728053249&date1=1554577200&date2=1554663600&period=hour&apikey=122951987

Ответ от сервера.

[{
ID    1728053249,      // ИД счетчика
TIME    1554577200,    // время в UNIX формате
STAT    143,
V1    224.4,           // напряжение на первой фазе (линии)
A1    4.14,            // ток на первой фазе (линии)
W1    881,             // активная мощность на первой фазе, потребление
rW1    0,              // реверсивная активная мощность на первой фазе, генерация
Wh1    39072099,       // энергия, накопительное потребление
rWh1    0,             // реверсивная энергия, накопительная выработка
PF1    0.93,           // Power Factor (cosФ)
V2    213.83,            . . .
A2    0.38,
W2    46,
rW2    0,
Wh2    5447882,
rWh2    0,
PF2    0.55,
V3    228.89,
A3    0.26,
W3    37,
rW3    0,
Wh3    7593723,
rWh3    0,
PF3    0.59,
T    10
}]

Экспорт в EXCEL

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

Откройте Visal  Basic for Excel -> меню "Tools" -> "References..."

Выберите и активируйте следующие библиотеки:

• Microsoft Scripting Runtime
• Microsoft Internet Controls
• Microsoft WinHTTP Services

Обратите внимание, что время данных на сервере сохраняется в GMT, по Гринвичу .

Скачать нужный файл можно по ссылкам ниже:

• однофазный энергомонитор smart-MAC D101 Скачать »
• трехфазный энергомонитор smart-MAC D103 Скачать »
• для импульсов и температур smart-MAC D105 Скачать »

Свои пожелания и замечания оставляете на форуме. Спросить »

Успехов в разработке!