Настройка URL веб-хука
Обозначения в документации
Далее адрес https://site.ru
будет обозначать адрес вашего сайта.
Полный путь до веб-хука
Веб-хук файл — это специальный PHP-файл, который автоматически копируется при установке модуля и обрабатывает входящие запросы от МойСклад.
Стандартное расположение
По умолчанию файл веб-хука располагается по адресу:
https://site.ru/mshooks/hook.php
Проверка доступности
Как проверить, что веб-хук работает:
- Откройте в браузере адрес:
https://site.ru/mshooks/hooks.php
- Вы должны увидеть пустую страницу — это означает, что файл доступен и работает корректно
Важные требования
- Файл должен открываться с HTTP статусом 200
- Не должно быть редиректов при обращении к файлу
- Страница должна загружаться без ошибок сервера
Настройка пользовательского пути
Гибкость размещения
Вы можете перемещать файл hook.php
в любое удобное место на вашем сервере.
Если вы переместили файл веб-хука:
- Укажите новый полный путь в настройках модуля
- Обновите все веб-хуки модуля для применения изменений
- Проверьте доступность по новому адресу
Пример пользовательского пути
https://site.ru/custom/folder/my-webhook.php
Дополнительная проверка веб-хука
Проверочная строка — это механизм безопасности для идентификации и защиты веб-хука от несанкционированных запросов.
Критически важно
Проверочная строка во всех настроенных веб-хуках должна совпадать. Несовпадение приведет к отказу в обработке запросов.
Что делает проверочная строка:
- Идентифицирует запросы от вашего модуля
- Защищает веб-хук от посторонних обращений
- Обеспечивает безопасность передачи данных
Решение проблем
Если у вас возникли проблемы с веб-хуками, изучите специальный раздел документации: