Интерфейс REST API и PMS | LiteLog
Открытый REST API для PMS и сторонних систем: подключайте объекты, задачи, сообщения и контрольные списки с помощью ключа API. Из пакета «Стандарт» (6-15 пользователей).
Открытый REST API для сторонних систем
С помощью REST API вы можете получить доступ к LiteLog из вашей системы управления недвижимостью, ERP или ваших собственных инструментов. Четыре ресурса охватывают повседневную интеграцию: объекты (прочитать, создать, изменить), задачи (прочитать, создать), сообщения (создать) и отправленные ответы, включая фотографии (прочитать). Интерфейс соответствует общим соглашениям REST с JSON и спецификацией OpenAPI.
- ✓Объекты, задачи, сообщения, формы ответов
- ✓Стандартный REST со спецификацией JSON и OpenAPI.
- ✓Доступ через API не занимает места пользователя
Гость уходит → уборка
Классика аренды квартир для отдыха: когда вы выезжаете, ваша PMS автоматически создает окончательное задание на уборку для нужного объекта недвижимости — благодаря защите от идемпотентности дублирующихся заданий никогда не возникает, даже если события отправляются дважды. После отправки контрольного списка уборки PMS получает результаты, включая фотографии. Поставщики услуг строительства подключают свои ERP или CAFM таким же образом для синхронизации основных данных объекта недвижимости.
- ✓Идемпотентные задачи — повторяющиеся события PMS никогда не создают две задачи.
- ✓Протокол передачи с фотографиями по запросу.
- ✓Синхронизировать основные данные объекта с системой управления
Ключи API и разрешения (области действия)
Вы сами создаете ключи API на портале — без обращения в службу поддержки. Каждый ключ привязан к вашему тенанту и доступу и видит именно те объекты, которые видит этот доступ. Разрешения (области действия) также ограничивают возможности каждого ключа. Необработанный ключ отображается ровно один раз; Отзыв вступает в силу немедленно, ротация выполняется без сбоев.
- ✓Детализированные разрешения для каждого ключа
- ✓Видимость, например связанный доступ
- ✓Немедленная отмена, ротация без сбоев
Безопасность и четкие границы
API рассчитан на надежную работу: 120 запросов в минуту на ключ, строгая проверка (неизвестные поля отклоняются) и четкие коды ошибок. И мы честно назовем то, чего (пока) не хватает: запланированы вебхуки — до тех пор вы можете запрашивать новые чек-листы по требованию; OAuth2 и удаление через API намеренно недоступны. Хостинг в Германии, соответствует требованиям GDPR.
- ✓120 запросов/минуту на ключ
- ✓Строгая проверка, четкие коды ошибок
- ✓Запланированы вебхуки – опрос сегодня
FAQ
Часто задаваемые вопросы по REST API (FAQ)
Из какого пакета доступен REST API?
REST API включен в пакет Standard (6–15 пользователей), а также доступен в пакетах Premium (16–30 пользователей) и Enterprise. В стартовый пакет он не входит.
Занимает ли доступ к API пользовательское пространство?
Нет. Доступ через API не занимает лицензионного места. Если срок действия лицензии истек, доступ на чтение остается открытым, а доступ на запись блокируется.
Есть ли вебхуки?
Пока нет — вебхуки планируются. До тех пор ваша сторонняя система будет запрашивать новые данные (опрос), например отправленные контрольные списки.
Какие данные я могу читать и записывать через API?
Чтение, создание и изменение объектов; читать и создавать задачи; создавать отчеты; Получить отправленные ответы на формы, включая ссылки на фотографии. Намеренно не включены удаление через API, загрузка файлов и запись времени записи.
Как создать и защитить ключ API?
На портале в разделе Настройки → Интеграции → REST API. При создании вы выбираете имя и разрешения; ключ отображается ровно один раз. Отзыв вступает в силу немедленно, и для изменения вы сначала создаете новый ключ, а затем отзываете старый — без каких-либо простоев.