Перейти к основному содержимому

Настройка URL веб-хука

Обозначения в документации

Далее адрес https://site.ru будет обозначать адрес вашего сайта.

Полный путь до веб-хука

Веб-хук файл — это специальный PHP-файл, который автоматически копируется при установке модуля и обрабатывает входящие запросы от МойСклад.

Стандартное расположение

По умолчанию файл веб-хука располагается по адресу:

https://site.ru/mshooks/hook.php

Проверка доступности

Как проверить, что веб-хук работает:

  1. Откройте в браузере адрес: https://site.ru/mshooks/hooks.php
  2. Вы должны увидеть пустую страницу — это означает, что файл доступен и работает корректно
Важные требования
  • Файл должен открываться с HTTP статусом 200
  • Не должно быть редиректов при обращении к файлу
  • Страница должна загружаться без ошибок сервера

Настройка пользовательского пути

Гибкость размещения

Вы можете перемещать файл hook.php в любое удобное место на вашем сервере.

Если вы переместили файл веб-хука:

  1. Укажите новый полный путь в настройках модуля
  2. Обновите все веб-хуки модуля для применения изменений
  3. Проверьте доступность по новому адресу

Пример пользовательского пути

https://site.ru/custom/folder/my-webhook.php

Дополнительная проверка веб-хука

Проверочная строка — это механизм безопасности для идентификации и защиты веб-хука от несанкционированных запросов.

Критически важно

Проверочная строка во всех настроенных веб-хуках должна совпадать. Несовпадение приведет к отказу в обработке запросов.

Что делает проверочная строка:

  • Идентифицирует запросы от вашего модуля
  • Защищает веб-хук от посторонних обращений
  • Обеспечивает безопасность передачи данных

Решение проблем

Если у вас возникли проблемы с веб-хуками, изучите специальный раздел документации:

📚 Частые проблемы при настройке веб-хука