API и вебхуки: как связать сайт с внешними сервисами

API — договорённость, как программы обмениваются данными по сети. Вебхук — push‑уведомление от сервиса к вашему URL при событии (оплата прошла, заказ собран).

Когда использовать API

Когда нужны запросы «по требованию»: получить статус заказа, создать контрагента, обновить остаток. Подходит для регулярной синхронизации и интерактивных форм.

Когда использовать вебхуки

Когда важна мгновенная реакция на событие без опроса API каждые N минут: меньше нагрузка и задержка.

Практика

Проверяйте подпись вебхука, отвечайте быстро (200 OK), делайте идемпотентную обработку — повтор одного события не должен ломать данные.