API для сервера

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

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

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

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

Основные возможности и ограничения:
  • В ответ на запрос приходят часовые данные за выбранный период.
  • Максимальный интервал данных: минутные 1440 строк (сутки), часовые 1080 строк (45 суток).
  • При неправильно заданном интервале, интервал будет максимальный, от даты окончания (data2).
  • При отсутствии в запросе date1 и date2, будут получены данные за один последний час. Последний час - это предыдущий текущему. Если данные отсутсвуют, запрос вернет пустой массив.
  • Дата отправляется в GMT в UNIX формате, с точностью до секунд.
  • При отсутствии date1 будет выбран максимальный интервал от date2.
  • Запросы можно отправлять не чаще, чем один раз в минуту.
Формат GET запроса для получения данных с сервера
https://dash.smart-mac.com/api?devid=[ИД устройства]&date1=[начало периода]&date2=[окончание периода]&period=[minute или hour]&apikey=[API key пользователя]
Формат POST запроса для получения данных с сервера
Адрес запроса: https://dash.smart-mac.com/api
Параметры запроса:
devid=[ИД устройства]    *) обязательный параметр
date1=[начало периода]
date2=[окончание периода]
period=[minute или hour]
apikey=[API key пользователя]    *) обязательный параметр

Пример GET запроса на сервер. Смотреть »
https://dash.smart-mac.com/api?devid=1728053249&date1=1554577200&date2=1554663600&period=hour&apikey=122951987

Экспорт в EXCEL

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

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

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

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

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

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

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

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

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