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

Диагностика: зачем использовать WooCommerce REST API для заказов на мобильных устройствах

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

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

Как подключиться к WooCommerce REST API с мобильного устройства

Создание API ключей

Перейдите в WooCommerce > Настройки > Расширенные > REST API и создайте новый ключ с правами read/write. Сохраните Consumer key и Consumer secret.

Пример запроса на получение заказов с помощью PHP

require_once 'vendor/autoload.php';
use Automattic\WooCommerce\Client;

$woocommerce = new Client(
    'https://example.com', // URL вашего сайта
    'ck_XXXXXXXXXXXXXXXXXXXXXXXXXXXX', // Consumer Key
    'cs_XXXXXXXXXXXXXXXXXXXXXXXXXXXX', // Consumer Secret
    [
        'version' => 'wc/v3',
        'timeout' => 15,
        'verify_ssl' => false
    ]
);

try {
    $orders = $woocommerce->get('orders', ['per_page' => 10]);
    foreach ($orders as $order) {
        echo "Заказ #" . $order->id . " - Статус: " . $order->status . "\n";
    }
} catch (Exception $e) {
    echo 'Ошибка API: ' . $e->getMessage();
}

Пошаговое решение: обновление статуса заказа через REST API

Частая задача — изменить статус заказа (например, на «в обработке» или «завершён»).

1. Получите ID заказа, который хотите обновить.

2. Сделайте PUT-запрос к эндпоинту /wp-json/wc/v3/orders/{id} с JSON телом:

{
  "status": "completed"
}

3. Пример запроса на PHP:

$data = [
    'status' => 'completed'
];

try {
    $updatedOrder = $woocommerce->put('orders/' . $order_id, $data);
    echo 'Статус заказа #' . $updatedOrder->id . ' обновлён на ' . $updatedOrder->status;
} catch (Exception $e) {
    echo 'Ошибка обновления: ' . $e->getMessage();
}

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

• Через админку WooCommerce проверьте статус заказа — он должен совпадать с обновлённым.
• Используйте Postman или curl для тестирования API вручную:

curl -X PUT https://example.com/wp-json/wc/v3/orders/123 \
    -u ck_XXXXXXXXXXXXXXXXXXXXXXXXXXXX:cs_XXXXXXXXXXXXXXXXXXXXXXXXXXXX \
    -H "Content-Type: application/json" \
    -d '{"status":"completed"}'

• В ответе API должен быть обновлённый объект заказа с новым статусом.

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

• Ошибка 401 Unauthorized: Неверные ключи API или недостаточно прав. Проверьте права доступа и корректность ключей.
• Ошибка 403 Forbidden: REST API отключен или доступ ограничен. Проверьте настройки безопасности, плагины защиты, .htaccess.
• Ошибка 404 Not Found: Неверный URL API или версия. Убедитесь, что URL соответствует /wp-json/wc/v3/ и WooCommerce активен.
• Ошибка 400 Bad Request: Неверный формат JSON или недопустимые поля. Проверьте структуру запроса и используемые поля.

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

• Используйте HTTPS для всех запросов к API.
• Ограничьте права созданных ключей API по принципу минимальных прав (только read/write, если нужно).
• Реализуйте ограничение доступа по IP, если API используется только с конкретных серверов или устройств.
• Кэшируйте результаты GET-запросов при возможности, чтобы снизить нагрузку.
• Для массовых обновлений используйте пакетные запросы с задержкой, чтобы избежать превышения лимитов сервера.

Сравнение основных методов работы с заказами WooCommerce на мобильных устройствах