Webhooks позволяют получать статусы отправлений сразу при их изменении, без постоянного опроса API. Это основа быстрых уведомлений клиенту. Разберём, как их настроить.
Что такое webhooks
Webhook — это уведомление, которое СДЭК отправляет на ваш сервер при событии: смене статуса, вручении, возврате. Вместо того чтобы ваш сайт постоянно спрашивал «что нового», система сама сообщает об изменениях.
Чем webhooks лучше опроса
- статусы приходят мгновенно, а не по расписанию;
- меньше нагрузка на API и ваш сервер;
- клиент быстрее получает уведомление о заказе.
Как настроить
- Укажите URL для приёма уведомлений в настройках.
- Обрабатывайте входящие события на своей стороне.
- Обновляйте статус заказа в базе и шлите уведомление клиенту.
Как защитить вебхуки
Проверяйте подлинность входящих запросов, чтобы никто не подделал статусы. Подписывайте и валидируйте запросы на своей стороне — это стандартная мера безопасности.
Выводы
Webhooks доставляют статусы отправлений мгновенно и снижают нагрузку по сравнению с опросом API. Укажите URL приёма событий, обрабатывайте их и обновляйте заказы, попутно уведомляя клиента. Обязательно валидируйте подлинность запросов, чтобы защититься от подделки статусов.