LogoLogo
  • Главная
  • FAQ
    • Возможности
    • Первичная настройка
    • Публичный сайт
    • Надежность
    • Стоимость и закрывающие документы
    • Коробочная версия
    • Подробнее о функциях
    • Интеграция с 1С
    • Шаблоны документов
    • Агентская схема
    • Категории помещений
    • Коммуналка
    • Торговый оборот
    • Пассажиропоток аэропортов
  • API
    • Доступ по API
    • Webhooks
    • Формирование номера договора
    • Согласование договоров и соглашений
    • Модальные окна
    • Импорт контрагентов и денежных операций
    • События публичного сайта
    • Перечисления
    • Сущности
Powered by GitBook
On this page
  • Типы сущностей
  • Типы действий
  1. API

Webhooks

PreviousДоступ по APINextФормирование номера договора

Last updated 1 year ago

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

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

  • Подписка

  • Сотрудники

  • Объекты

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

  • Договоры

  • Счета и акты

  • Деньги

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

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

POST {Ваш URL}
HTTP-заголовки
User-Agent: Pro.rent/{версия}
X-Prorent-Type: {тип сущности}
X-Prorent-Action: {действие}
Body
{
    type: string, // Тип сущности
    action: string, // Действие
    data: ApiСущность,
    referer: string, // Значение HTTP-заголовка "Referer" исходного запроса (если заголовок был)
    operationId: string // Значение HTTP-заголовка "X-Operation-Id" исходного запроса (если заголовок был)
}

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

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

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

  • ApiSubscription – аккаунт.

  • ApiEmployee – сотрудник.

  • ApiBuilding – объект.

  • ApiContractor – контрагент.

  • ApiContract – договор.

  • ApiDocument – счёт, акт, претензия, акт РСО или справка РСО.

  • ApiPayment – платеж.

  • ApiFeedback – запрос обратной связи.

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

  • Create

  • Update

  • Delete

В поле data запроса передается сущность из согласно типу. Поля referer и operationId можно использовать для фильтрации изменений.

Настройки портала => Webhooks
swagger-схемы