API для сервера

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

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

Для роботи з API необхідний API key, який можна отримати на сторінці профілю smart-MAC Dashboard.

Ця функція доступна для ліцензії БІЗНЕС.


Image 161

Основні можливості та обмеження:

У відповідь на запит надходять годинникові дані за вибраний період.
Максимальний інтервал даних: хвилинні 1440 рядків (добу), вартові 1080 рядків (45 діб).
При неправильно заданому інтервалі інтервал буде максимальний, від дати закінчення (data2).
За відсутності запиту date1 і date2, будуть отримані дані за останню годину. Остання година – це попередня поточна. Якщо дані відсутні, запит поверне порожній масив.
Дата відправляється в GMT в UNIX форматі, з точністю до секунд.
За відсутності date1 буде вибрано максимальний інтервал від date2.
Запити можна надсилати не частіше ніж один раз на хвилину.

Формат GET запиту для отримання даних із сервера
https://dash.smart-maic.com/api?devid=[ID пристрою]&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

Експорт до EXCEL

Експортувати дані до EXCEL зручно прямо з сервера за допомогою API. Спробуйте простий файл у роботі, з його допомогою можна швидко завантажити в EXCEL годинні дані за запитом API на сервер, для подальшої обробки та аналізу. Для запуску файлу потрібно встановити кілька бібліотек.

Відкрийте Visal Basic for Excel -> меню "Tools" -> "References..."
Виберіть та активуйте такі бібліотеки:
Microsoft Scripting Runtime
Microsoft Internet Controls
Microsoft WinHTTP Services

Зверніть увагу, що час даних на сервері зберігається в GMT за Грінвічем .
Завантажити потрібний файл можна за посиланнями нижче:

Однофазний енергомонітор smart-MAC D101. Завантажити »

Свої побажання та зауваження залишаєте на форумі. Запитати »

Успіхів у розробці!

Ця стаття допомогла 35 людям. Чи допомогла вам ця стаття?