Как использовать REST API для синхронизации полей WooCommerce между сайтами

Диагностика проблемы: почему стандартной синхронизации недостаточно

При работе с несколькими сайтами WordPress на WooCommerce часто возникает необходимость синхронизировать не только стандартные данные заказов и товаров, но и пользовательские поля (custom fields), которые используются для расширения функционала магазина. Стандартные REST API эндпоинты WooCommerce не всегда передают эти поля, из-за чего данные расходятся и появляется рассинхронизация.

Если вы заметили, что дополнительные мета-поля товаров или заказов не синхронизируются при использовании стандартных методов (например, вебхуков или экспорта/импорта), значит, нужно настроить расширение REST API для работы с этими полями.

Расширение WooCommerce REST API для пользовательских полей

Что нужно сделать

Добавить регистрацию пользовательских полей в REST API с помощью register_meta и расширить ответ API, чтобы включать нужные метаданные.

Пример: регистрация пользовательского поля для товаров

function register_custom_product_meta() {
    register_post_meta('product', '_custom_field', [
        'show_in_rest' => true,
        'single' => true,
        'type' => 'string',
        'auth_callback' => function() {
            return current_user_can('edit_products');
        }
    ]);
}
add_action('init', 'register_custom_product_meta');

Этот код позволит получить и обновить поле _custom_field через REST API для продуктов.

Пример: расширение REST API заказа с пользовательским полем

function add_order_custom_field_to_rest() {
    register_post_meta('shop_order', '_order_custom_field', [
        'show_in_rest' => true,
        'single' => true,
        'type' => 'string',
        'auth_callback' => function() {
            return current_user_can('edit_shop_orders');
        }
    ]);
}
add_action('init', 'add_order_custom_field_to_rest');

Пошаговое решение для синхронизации

1. Определите пользовательские поля, которые нужно синхронизировать (например, метаполя товара или заказа).
2. Добавьте регистрацию этих полей в REST API, как показано выше.
3. Используйте REST API запросы для чтения данных с одного сайта и записи на другой. Например, получить продукт с пользовательскими полями:
   

   GET /wp-json/wc/v3/products/123

4. Для обновления отправьте PATCH или PUT запрос с нужными полями:
   

   PUT /wp-json/wc/v3/products/123
   {
     "meta_data": [
       {
         "key": "_custom_field",
         "value": "Новое значение"
       }
     ]
   }

5. Реализуйте скрипт или задачу WP-Cron для регулярной синхронизации данных между сайтами.

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

• Сделайте GET запрос к REST API для товара или заказа, проверьте, что в ответе присутствуют пользовательские поля.
• Обновите значение поля через REST API на одном сайте, затем выполните синхронизацию и проверьте на втором сайте, что поле обновилось.
• Проверьте права доступа: API должен отдавать данные только авторизованным пользователям с нужными правами.

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

• Пользовательские поля не отображаются в API. Проверьте параметр show_in_rest в register_post_meta. Он должен быть true.
• Ошибка доступа 401 или 403 при запросах. Убедитесь, что используемый API ключ или токен имеет права на редактирование соответствующих объектов (товаров или заказов).
• Синхронизация не происходит автоматически. Проверьте, что настроен корректный WP-Cron или внешняя задача для запуска синхронизации.
• Метаданные не обновляются. При отправке данных используйте правильный формат для meta_data в JSON, как в примерах выше.

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

• Ограничьте доступ к REST API метаданным с помощью auth_callback, чтобы предотвратить утечку данных.
• Используйте HTTPS для всех API запросов.
• Оптимизируйте частоту синхронизации, чтобы не перегружать сервер и не получить ошибку 429 «Слишком много запросов».
• Кешируйте полученные данные на стороне клиента или промежуточного сервера, если это возможно.
• Для сложных сценариев синхронизации рассмотрите использование очередей и временных меток для инкрементального обновления.

Сравнение вариантов реализации синхронизации пользовательских полей WooCommerce