Как изменить URL вебхуков WooCommerce без плагинов

Проблема: необходимость изменить URL вебхуков WooCommerce

Вебхуки WooCommerce часто используются для интеграции с внешними сервисами — например, платежными системами, CRM, или системами аналитики. По умолчанию WooCommerce формирует URL вебхуков на базе wp-json/wc/v3/webhooks или wp-json/wc/v2/webhooks. Иногда возникает задача изменить этот URL — например, скрыть его от посторонних, изменить для соответствия требованиям безопасности или интеграции.

WooCommerce не предоставляет встроенного интерфейса для изменения базового URL вебхуков, а плагины для этого встречаются редко и часто избыточны. Поэтому разберёмся, как сделать это программно без сторонних плагинов.

Диагностика текущих URL вебхуков

Чтобы понять, какой URL используется для вебхуков, можно сделать простую проверку:

• Перейдите в WooCommerce → Настройки → Расширенные → Вебхуки и выберите любой вебхук.
• Скопируйте URL вебхука и проверьте, что он начинается с https://yourdomain.com/wp-json/wc/v3/webhooks/.
• Выполните curl или используйте Postman, чтобы отправить запрос на этот адрес и убедитесь, что вебхук отвечает.

Это позволит точно знать, что вы изменяете.

Пошаговое решение: изменение URL вебхуков WooCommerce через фильтры WordPress REST API

WooCommerce регистрирует свои REST API маршруты через WordPress REST API. Мы можем переопределить или добавить собственный маршрут, чтобы изменить URL вебхуков.

Шаг 1. Отключаем стандартный маршрут вебхуков WooCommerce

add_action('rest_api_init', function () {
    remove_action('rest_api_init', ['WC_REST_Webhooks_V3_Controller', 'register_routes']);
});

Этот код удалит регистрацию стандартного маршрута для версии API v3 вебхуков.

Шаг 2. Регистрируем свой маршрут с новым URL

add_action('rest_api_init', function () {
    register_rest_route(
        'custom-wc/v3', // Новый namespace
        '/webhooks/(?P<id>\d+)',
        [
            'methods'             => WP_REST_Server::READABLE,
            'callback'            => ['Custom_WC_REST_Webhooks_Controller', 'get_item'],
            'permission_callback' => ['Custom_WC_REST_Webhooks_Controller', 'get_item_permissions_check'],
            'args'                => [
                'id' => [
                    'validate_callback' => 'is_numeric'
                ]
            ],
        ]
    );

    // Аналогично регистрируем остальные методы (POST, PUT, DELETE) при необходимости
});

Обратите внимание, что нужно реализовать свой контроллер Custom_WC_REST_Webhooks_Controller, который наследует логику от WC_REST_Webhooks_V3_Controller, чтобы переиспользовать функционал WooCommerce.

Шаг 3. Создаём класс контроллера с переопределением namespace

if (class_exists('WC_REST_Webhooks_V3_Controller')) {
    class Custom_WC_REST_Webhooks_Controller extends WC_REST_Webhooks_V3_Controller {
        protected $namespace = 'custom-wc/v3';

        public function __construct() {
            $this->namespace = 'custom-wc/v3';
            $this->rest_base = 'webhooks';
            parent::__construct();
        }
    }
}

Проверка результата после внедрения

• Перейдите по новому URL вебхуков, например, https://yourdomain.com/wp-json/custom-wc/v3/webhooks/123. Ответ должен быть аналогичным стандартному.
• Старый URL https://yourdomain.com/wp-json/wc/v3/webhooks/123 должен вернуть ошибку 404.
• Проверьте работу интеграционных сервисов, которые используют вебхуки, чтобы убедиться, что они подключаются по новому адресу.

Частые ошибки и как их исправить

• Ошибка 404 на новом URL: возможно, не отключён стандартный маршрут, или контроллер не зарегистрирован. Проверьте порядок хуков rest_api_init и правильность регистрации контроллера.
• Права доступа не работают: убедитесь, что в контроллере корректно реализованы методы permission_callback.
• Кэширование REST API мешает проверить изменения: очистите кеш плагинов и браузера.

Практические советы по безопасности и производительности

• Изменение URL вебхуков помогает затруднить несанкционированный доступ, но не заменяет полноценную авторизацию и проверку прав.
• Добавьте проверку IP адресов, если вебхуки используются только с фиксированных серверов.
• Используйте HTTPS для всех вебхуков, чтобы обеспечить шифрование передаваемых данных.
• Минимизируйте нагрузку на REST API, отключая ненужные маршруты и контроллеры.

Сравнение вариантов изменения URL вебхуков WooCommerce

Метод	Плюсы	Минусы	Компромисс
Использование плагина	Быстро, нет необходимости писать код	Может быть избыточно, не всегда гибко	Подходит для простых задач
Кодовое переопределение маршрутов (описано в статье)	Максимальный контроль, нет лишних зависимостей	Требует технических знаний, возможны ошибки	Оптимально для опытных разработчиков
Изменение через переопределение REST API в WordPress	Гибко и мощно	Сложно для новичков, требует тестирования	Подходит для кастомных решений