Событие не определено
«Изменился статус» недостаточно: требуется список точных событий и момент, когда каждое из них считается состоявшимся.
Профессиональное сопровождение библиотечных фондов и частных коллекцийИз Дюссельдорфа по всему миру
Webhook не заменяет весь обмен: он сообщает библиотеке о заранее согласованном событии и требует надёжной стороны-получателя.
Мы комплектуем библиотеки только русскими и украинскими книгами.
Опишите задачу библиотекиРоль системы и передача данных проектируются для учреждения; стандартная интеграция не заявляется.
01
«Изменился статус» недостаточно: требуется список точных событий и момент, когда каждое из них считается состоявшимся.
Сетевой сбой или ошибочный URL не должны приводить к незаметной потере библиотечного уведомления.
02
До подключения определяются типы событий, полезная нагрузка, подпись, URL получателя, повторные попытки и порядок обработки недоставленного сообщения.
03 / Пример согласованного профиля
Получаем привычные библиотеке данные закупки, проверяем издание и наличие, затем возвращаем согласованные поля в её рабочий процесс.
ISBN, список изданий, номер заказа и необходимые библиотеке закупочные реквизиты.
Сопоставляем поля, проверяем обязательные значения и готовим ограниченный тест для приёмки.
Проверенные библиографические данные, цену и статус в согласованном формате и по выбранному каналу.
Пример иллюстративный. Поля, кодировка, валидация и транспорт согласуются до пилота.
{
"event": "<agreed-event>",
"bookId": 131711,
"isbn": "978-5-17-160839-2",
"status": "stock"
}
signature · retries · timing → <agreed contract>04
Выбираем только уведомления, которые библиотека действительно будет обрабатывать.
На тестовом endpoint проверяем секрет, формат payload и код ответа.
Фиксируем, как стороны видят повторы и что делают при постоянной ошибке.
05
Payload содержит библиотечную ссылку, новый статус и время обновления, а подпись позволяет проверить отправителя.
06
Библиотечная система получает только согласованные сигналы.
Подпись и повторы описаны до пилота, а не остаются неявными.
07 / Exlibrus