API для сервера

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

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

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

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

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

Формат GET запроса для получения данных с сервера
https://dash.smart-mac.com/api?devid=[ИД устройства]&date1=[начало периода]&date2=[окончание периода]&apikey=[API key пользователя]
Формат POST запроса для получения данных с сервера
Адрес запроса: https://dash.smart-mac.com/api
Парамерты запроса:
devid=[ИД устройства]
date1=[начало периода]
date2=[окончание периода]
apikey=[API key пользователя]

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

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

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

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