API

Программный интерфейс к службе m2data.net (далее API m2data) дает возможность компаниям получать данные, хранящиеся на платформе m2data.net практически в реальном времени.

С помощью API m2data вы сможете получать информацию по:

  • нежилым зданиям (общие, тех. характеристики и другую информацию)
  • свободным помещениям в аренду
  • свободным помещениям на продажу
  • контакты собственников и других ответственных лиц за сдачу в аренду/продажу 
  • данные по коворкингам и гибким офисам, включая свободные рабочие места
  • архивные данные (списки сданных/проданных нежилых помещений)

 

Как работает API

 

API m2data реализовано на REST-принципах (https://ru.wikipedia.org/wiki/REST) с использованием HTTP и JSON для обмена данными. Клиентское приложение обменивается JSON-сообщениями с сервером API m2data посредством HTTP-запросов: Ресурсы сайтов получаются методом HTTP GET, и POST.

API m2data.net доступен для идентифицированных пользователей по адресу: https://m2data.net/api 

Запросы к API могут содержать параметры двух типов:

  • Path-параметры — параметры, являющиеся частью URL ресурса.
  • Query-параметры — параметры, добавленные к URL ресурса после знака «?».

Так как все действия в API m2data выполняются от имени конкретного пользователя, клиентское приложение должно быть авторизовано: получен уникальный токен и выполнена проверка по статическому IP.

 

Документация Swagger. Более подробную информацию об ответах можно смотреть в swagger по адресу https://m2data.net/ru/api/doc 

 

Связь. Чтобы воспользоваться сервисом сначала необходимо подать заявку по эл.почте, указав ФИО, название организации и обратные контакты для связи sales@m2data.net

 

Часто задаваемые вопросы

 

В: Как получить всю информацию по помещениям?

О: Т.к много данных за раз передавать медленно, для API работает пагинация.
Для получения данных необходимо отправить запрос по интересующему помещению (например помещению в аренду), и получить оттуда информацию по помещениям, и url (next_page) который ведет на следующую страницу пагинации.

В: Как узнать “вымывание” рынка за последний месяц?

О: Необходимо отправлять запросы на получение записей архивирования до тех пор, пока поле archived_at попадает в диапазон даты.

В: Здание попало в архив, могу ли я как-то узнать об этом?

О: Вместе со зданием мы отправляем его статус. По умолчанию здания отправляются только со статусом active. Но в случае если здание перенесено в архив, то в течении следующих 10-ти дней оно все еще будет приходить в ответе.

В: Во всех сущностях поле\поля приходят пустые, что делать?

О: Необходимо уточнить у модератора включено ли поле\поля для отображения.

В: При запросе выдает ошибку, и статус-код  401.

О: В заголовке запроса не передается токен, либо токен не валиден.

В: Раньше запрос отправлялся нормально, стал выдавать ошибку авторизации.

О: Либо срок действия токена истек, либо потому что изменился токен остался старый, а IP адрес с которого отправляется запрос изменился. Нужно получить новый токен.