Интеграцию с Рососмотр можно поделить на несколько этапов:
1. Создание интеграционного профиля пользователя
2. Настройка интеграции через API Рососмотр
3. Настройка Webhook
4. Типовая настройка
Создание интеграционного профиля пользователя
Для настройки интеграции рекомендуется создать отдельный профиль пользователя. Как создать пользователя описано на странице
Добавление пользователя в Рососмотр. Отличие интеграционного профиля от обычного в установленном флаге "
Разрешить доступ к integrapi (api для интеграции)"
Настройка интеграции через API Рососмотр
Следующим этапом необходимо настроить использование методов API Рососмотр.
Функции, доступные в API, фактически повторяют функционал веб-интерфейса.
Подробная информация о самих методах с описанием технической составляющей находится на странице
Integrapi
Настройка Webhook
Следующим этапом необходимо настроить получение Webhook.
Актуальная информация о работе webhook находится на странице
Webhook
Типовая настройка
По итогу, настроенная интеграция должна соответствовать следующей схеме:
- Через веб-интерфейс настраиваются необходимые Схемы осмотра и разграничивается видимость по Группам доступа
- Через integrapi настраивается создание и управление Пользователями - то есть, создания полноценной учётной записи с присвоением нужной Роли и Групп доступа
- Через webhook'и настраивается получение информации о изменениях, происходящих с осмотрами (в частности - о Создании и смене Статуса осмотров)
- После получения информации о Созданном осмотра или об изменении Статуса осмотра, через integrapi настраивается получение полной информации об осмотре
Важно! Учитывайте особенности работы с integrapi и webhook:
- необходимо создать отдельную учётную запись исключительно для использования с integrapi
- необходимо дожидаться получения ответа на каждый запрос, сделанный в integrapi, ДО отправки следующего запроса
- необходимо кэшировать token для того, чтобы не запрашивать авторизацию перед каждым запросом
- необходимо обрабатывать webhook'и, а именно - фильтровать по нужной схеме осмотра и/или пользователю
Вопросы о настройке интеграции всегда можно задать представителю компании.