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

Автор: Вадим Попов | Опубликовано: 07.02.2026

WooCommerce REST API предоставляет мощный инструмент для взаимодействия с вашим интернет-магазином на базе WordPress. С помощью API можно автоматизировать обработку заказов, интегрировать магазин с внешними сервисами, а также создавать уникальные решения для управления заказами.

Что такое WooCommerce REST API и зачем он нужен

WooCommerce REST API — это набор HTTP-интерфейсов, позволяющих получать данные о товарах, заказах, клиентах и других сущностях магазина, а также создавать, обновлять и удалять эти данные программно. Это особенно полезно, если вы хотите:

Автоматизировать обработку заказов и их статусов
Интегрировать магазин с ERP, CRM или другими системами
Создавать собственные панели управления или мобильные приложения

API поддерживает методы GET, POST, PUT, DELETE для работы с сущностями WooCommerce. Для доступа к API нужно создать ключи API в админке WooCommerce и использовать их для аутентификации.

Как получить ключи для работы с WooCommerce REST API

Для начала работы с API выполните следующие шаги:

Перейдите в админке WordPress в раздел WooCommerce > Настройки > Продвинутые > REST API.
Нажмите кнопку «Добавить ключ».
Введите описание, выберите пользователя и задайте права доступа (чтение, запись или чтение и запись).
Сохраните и скопируйте сгенерированные Consumer Key и Consumer Secret. Они понадобятся для запросов к API.

Рекомендуется использовать HTTPS для безопасности данных при работе с API.

Пример получения списка заказов через WooCommerce REST API

Рассмотрим пример кода, который можно использовать в вашем плагине или теме для получения и вывода списка заказов.

function wpupgrade_get_woocommerce_orders() {
    $url = 'https://example.com/wp-json/wc/v3/orders';
    $consumer_key = 'ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
    $consumer_secret = 'cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';

    $args = array(
        'headers' => array(
            'Authorization' => 'Basic ' . base64_encode($consumer_key . ':' . $consumer_secret),
        ),
    );

    $response = wp_remote_get($url, $args);

    if (is_wp_error($response)) {
        return 'Ошибка запроса: ' . $response->get_error_message();
    }

    $orders = json_decode(wp_remote_retrieve_body($response), true);

    if (empty($orders)) {
        return 'Заказы не найдены';
    }

    foreach ($orders as $order) {
        echo 'Заказ #' . $order['id'] . ' от ' . $order['date_created'] . ' - Статус: ' . $order['status'] . '<br>';
    }
}

Этот код обращается к эндпоинту /wp-json/wc/v3/orders, авторизуется с помощью ключей и выводит базовую информацию по каждому заказу.

Создание нового заказа через API: практический пример

Создание заказа программно — более сложная задача, так как нужно передать правильно структурированные данные. Пример создания простого заказа:

function wpupgrade_create_woocommerce_order() {
    $url = 'https://example.com/wp-json/wc/v3/orders';
    $consumer_key = 'ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
    $consumer_secret = 'cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';

    $order_data = array(
        'payment_method' => 'bacs',
        'payment_method_title' => 'Direct Bank Transfer',
        'set_paid' => true,
        'billing' => array(
            'first_name' => 'Иван',
            'last_name' => 'Иванов',
            'address_1' => 'ул. Ленина, д.1',
            'city' => 'Москва',
            'postcode' => '101000',
            'country' => 'RU',
            'email' => 'ivan@example.com',
            'phone' => '+7 999 123 45 67'
        ),
        'line_items' => array(
            array(
                'product_id' => 123,
                'quantity' => 2
            )
        )
    );

    $args = array(
        'method' => 'POST',
        'headers' => array(
            'Authorization' => 'Basic ' . base64_encode($consumer_key . ':' . $consumer_secret),
            'Content-Type' => 'application/json'
        ),
        'body' => json_encode($order_data)
    );

    $response = wp_remote_post($url, $args);

    if (is_wp_error($response)) {
        return 'Ошибка создания заказа: ' . $response->get_error_message();
    }

    $result = json_decode(wp_remote_retrieve_body($response), true);

    if (isset($result['id'])) {
        return 'Заказ #' . $result['id'] . ' успешно создан';
    } else {
        return 'Ошибка при создании заказа';
    }
}

Обратите внимание, что product_id должен соответствовать реальному ID товара в WooCommerce. Также можно добавить адрес доставки, купоны и другие параметры в массив $order_data.

Обновление статуса заказа через WooCommerce REST API

Для изменения статуса заказа используйте метод PUT. Пример кода для установки статуса «выполнен»:

function wpupgrade_update_order_status($order_id, $new_status) {
    $url = 'https://example.com/wp-json/wc/v3/orders/' . $order_id;
    $consumer_key = 'ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
    $consumer_secret = 'cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';

    $data = array(
        'status' => $new_status
    );

    $args = array(
        'method' => 'PUT',
        'headers' => array(
            'Authorization' => 'Basic ' . base64_encode($consumer_key . ':' . $consumer_secret),
            'Content-Type' => 'application/json'
        ),
        'body' => json_encode($data)
    );

    $response = wp_remote_request($url, $args);

    if (is_wp_error($response)) {
        return 'Ошибка обновления заказа: ' . $response->get_error_message();
    }

    $result = json_decode(wp_remote_retrieve_body($response), true);

    if (isset($result['status']) && $result['status'] === $new_status) {
        return 'Статус заказа #' . $order_id . ' обновлен на ' . $new_status;
    } else {
        return 'Ошибка при обновлении статуса';
    }
}

Вызывайте функцию с нужным ID заказа и статусом, например wpupgrade_update_order_status(123, 'completed').

Полезные плагины для работы с WooCommerce REST API

Для расширения возможностей API и удобства работы рекомендуем обратить внимание на следующие плагины:

Clearfy Pro — оптимизация WooCommerce и улучшение безопасности API.
WPCommunity — расширение для интеграции пользовательских данных с API.
Expert Review — позволяет автоматически собирать отзывы и данные через API.

Эти решения помогут вам построить более гибкую и функциональную систему управления магазином.

Советы по безопасности при работе с WooCommerce REST API

Работая с REST API, обязательно соблюдайте следующие рекомендации:

Используйте HTTPS для защиты данных при передаче.
Создавайте API-ключи с минимально необходимыми правами доступа.
Храните ключи в безопасном месте, не добавляйте их в публичный код.
Ограничивайте доступ по IP, если возможно.
Следите за обновлениями WooCommerce и своевременно обновляйте плагин.

Безопасность критична, так как через API можно изменять данные магазина и заказы.

Выводы и рекомендации по использованию WooCommerce REST API

WooCommerce REST API — мощный инструмент для разработчиков, который позволяет создавать гибкие решения для управления заказами и интеграции с внешними системами. Благодаря поддержке стандартных HTTP-методов и JSON, работать с API удобно и просто.

Начинайте с базовых операций — получения и вывода заказов, затем переходите к созданию и обновлению данных. Обязательно учитывайте безопасность и используйте надежные методы аутентификации.

Для удобства и расширения возможностей можно использовать профессиональные плагины, такие как Clearfy Pro и другие, которые помогут оптимизировать работу магазина и API.