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

Webhook – это механизм, который позволяет отправлять уведомления сторонним приложениям о произошедших в LiveSklad событиях. В отличие от API, при работе с webhook не нужно выполнять никаких запросов, система сама отправит нужные данные в случае наступления заданного события. Таким образом, с помощью webhook можно быстро получать актуальную информацию об изменившихся в системе данных. Webhook можно настроить в [личном кабинете](https://my.livesklad.com/settings/webhooks).

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

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

<figure><img src="https://2774753422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzByu5Y8mhMOXYbMrOI%2Fuploads%2FrQGmeSDlyP8CAlMwPIOK%2Fimage.png?alt=media&#x26;token=a4cf6589-7d3e-4232-af9f-4d4b30402504" alt=""><figcaption><p>Подтверждение URL-адреса</p></figcaption></figure>

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

<figure><img src="https://2774753422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzByu5Y8mhMOXYbMrOI%2Fuploads%2Ft9kyLjyhcxHIH46N8kQ8%2Fimage.png?alt=media&#x26;token=6edc92b2-a23d-4eb4-9ee4-d3380ac72427" alt=""><figcaption><p>URL-адрес успешно подтвержден</p></figcaption></figure>

{% hint style="info" %}
После отправки Webhook система будет ждать ответ в течение 3 секунд. Если ответ будет некорректным или не поступит вовремя, система LiveSklad предпримет еще 2 попытки повторной отправки, первая через 60 секунд и вторая через 15 минут. В общей сложности система делает три попытки отправки, после этого уведомление считается недоставленным.
{% endhint %}

{% hint style="info" %}
Все уведомления от LiveSklad (кроме тестовых запросов) будут приходить с IP-адресов:

185.148.83.31\
185.127.148.28\
178.57.79.83
{% endhint %}

{% hint style="warning" %}
В случае если в течение часа было более 50 безуспешных попыток отправки уведомлений, webhook будет принудительно отключен в целях безопасности. Вы сможете повторно его активировать вручную.
{% endhint %}