Webhooks

Вы можете получать программные оповещения о событиях, произошедших в pro.rent, посредством отправки уведомлений.

Для настройки перейдите в раздел Настройки портала => Webhooks, укажите ссылку и типы сущностей, по которым отправлять уведомления:

  • Подписка

  • Сотрудники

  • Объекты

  • Контрагенты

  • Договоры

  • Счета и акты

  • Деньги

  • Обратная связь

При создании, изменении или удалении выбранной сущности, система отправит запрос:

POST {Ваш URL}
HTTP-заголовки
User-Agent: pro.rent
X-Prorent-Type: {тип сущности}
X-Prorent-Action: {действие}
Body
{ type: "{тип сущности}",
action: "{действие}",
data: {api-сущность}
}

В поле data запроса передается сущность из swagger-схемы согласно типу.

В ответ система ожидает успешный HTTP код 2xx. Система будет пытаться доставить webhook максимум 10 раз.

На обработку webhook система дает 10 секунд, за которые необходимо вернуть HTTP код 2xx.

Типы сущностей

  • Subscription (подписка)

  • Employee (сотрудник)

  • Building (объект)

  • Contractor (контрагент)

  • Contract (договор)

  • Document (счет или акт)

  • Payment (платеж)

  • Feedback (запрос обратной связи)

Типы действий

  • Create

  • Update

  • Delete