Вебхуки или опрос API: как получать изменения без пропусков

Когда использовать вебхуки, а когда периодический опрос API: задержка, повторы, подпись, курсор, лимиты и восстановление пропущенных событий.

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

Оцените требования

Для секундной реакции удобен вебхук, а редкая сверка допускает polling с курсором и разумным интервалом. Лимиты учитывайте.

Защитите приемник

Проверяйте подпись и время события, отвечайте быстро, обрабатывайте асинхронно и используйте идентификатор для защиты от дубля. Секрет ротируйте.

Планируйте восстановление

Поставщик может повторить событие или не доставить его, поэтому нужен журнал, повтор и периодическая сверка через API. Пробелы находите.

Действительно надежная схема часто сочетает подписанные вебхуки для скорости и регулярный опрос контрольной точки для гарантированного восстановления, никогда не предполагая идеальную доставку внешней системой.

Повторы и идемпотентность подробнее разобраны в материале про обмен CRM и 1С. Защиту приемника настраивайте отдельно.