Введение

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

Сущности и отношения между ними

Ниже предоставлена ER-диаграмма в контексте пользователя

Устройство - это некий "пропускной пункт", через который можно пройти при наличии данных доступа (кодов) к данному устройству. Устройства могут вложенными, например ворота во двор с домофоном, подъездная дверь с домофоном, тамбурная дверь с умным замком итд. На текущий момент поддерживаются следующие типы устройств: кейбокс (мини-сейф с ключом, открывающийся 4-значным кодом), домофон (открывается вводом специального кода), умный электронный замок TTLock (позволяет генерить временный код доступа на определенный период дат).

Помещение - это конечная цель доступа (квартира, апартаменты, коммерческая студия, частный дом итд), в которую попадаешь после прохода через последнее устройство.

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

Доступ в помещение - это данные, которые позволяют попасть в это помещение в назначенный временной промежуток. Включает в себя коды доступа каждого устройства из цепочки по пути в помещение и медиафайлы помещения.

События - данные об изменении доступов и открывании устройств в реальном времени.

Пример

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