Общие правила и ограничения

Webhook – это механизм, который позволяет отправлять уведомления сторонним приложениям о произошедших в LiveSklad событиях. В отличие от API, при работе с webhook не нужно выполнять никаких запросов, система сама отправит нужные данные в случае наступления заданного события. Таким образом, с помощью webhook можно быстро получать актуальную информацию об изменившихся в системе данных. Webhook можно настроить в личном кабинете.

Для получения таких уведомлений необходимо создать URL-адрес который будет принимать POST-запросы с информацией о событиях из LiveSklad. Все запросы отправляются по протоколу HTTPS в формате JSON.

Прежде чем система начнет отправлять уведомления, нужно будет подтвердить URL-адрес. Для этого в разделе с настройками нужно взять сгенерированное значение и вернуть его в ответе на проверочный запрос с URL-адреса:

Подтверждение URL-адреса

После успешного подтверждения URL-адреса на все последующие запросы необходимо отвечать сообщением "OK" и статусом 200, таким образом подтверждается успешное получение уведомления:

URL-адрес успешно подтвержден

После отправки Webhook система будет ждать ответ в течение 2 секунд. Если ответ будет некорректным или не поступит вовремя, система LiveSklad предпримет еще 2 попытки повторной отправки с интервалом в 15 минут. В общей сложности система делает три попытки отправки, после этого уведомление считается недоставленным.

Все уведомления от LiveSklad (кроме тестовых запросов) будут приходить с IP-адресов:

185.148.83.31 185.127.148.28 178.57.79.83

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