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 адрес с которого отправляется запрос изменился. Нужно получить новый токен.