Автоматическое создание заказов через REST API в WordPress

Автор: Наталья Громова | Опубликовано: 15.02.2026

В современных магазинах на WordPress часто возникает задача автоматического создания заказов из внешних систем или приложений. REST API WordPress предоставляет гибкие возможности для интеграции, но для заказов, особенно если используется WooCommerce, нужно учитывать особенности работы с API и безопасностью. В этой статье разберём, как реализовать автоматическое создание заказов через REST API в WordPress, уделив внимание практическим моментам и примерам кода.

Что такое REST API и зачем использовать его для заказов

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

Использование REST API для заказов позволяет:

Автоматизировать процесс оформления заказов из CRM, мобильных приложений, ERP-систем.
Интегрировать ваш магазин с внешними маркетплейсами и сервисами доставки.
Минимизировать ручной ввод и ошибки.

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

Подключение и настройка REST API WooCommerce

Для начала нужно убедиться, что в вашем магазине установлен и активирован WooCommerce. REST API включён по умолчанию, но для безопасного доступа необходимо создать ключи API.

Чтобы создать ключи:

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

Далее можно работать с заказами через REST API по адресу:

https://ваш-сайт.ru/wp-json/wc/v3/orders

Пример запроса на создание заказа

Для создания заказа POST-запрос должен содержать JSON с данными покупателя, товарами, оплатой и доставкой. Пример:

POST /wp-json/wc/v3/orders
Authorization: Basic base64_consumer_key_consumer_secret
Content-Type: application/json

{
  "payment_method": "bacs",
  "payment_method_title": "Direct Bank Transfer",
  "set_paid": true,
  "billing": {
    "first_name": "Иван",
    "last_name": "Иванов",
    "address_1": "ул. Ленина, 1",
    "city": "Москва",
    "postcode": "101000",
    "country": "RU",
    "email": "ivan@example.com",
    "phone": "+79991234567"
  },
  "line_items": [
    {
      "product_id": 123,
      "quantity": 2
    },
    {
      "product_id": 456,
      "variation_id": 789,
      "quantity": 1
    }
  ]
}

В ответе вы получите JSON с информацией о созданном заказе.

Реализация функции автоматического создания заказа на стороне WordPress

Для автоматизации можно написать функцию с префиксом wporder_, которая будет принимать данные и создавать заказ через REST API программно.

Пример функции на PHP:

function wporder_create_order_via_api($order_data) {
    $url = site_url('/wp-json/wc/v3/orders');
    $consumer_key = 'ck_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
    $consumer_secret = 'cs_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';

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

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

    if (is_wp_error($response)) {
        return ['error' => $response->get_error_message()];
    }

    $code = wp_remote_retrieve_response_code($response);
    $body = wp_remote_retrieve_body($response);

    if ($code !== 201) {
        return ['error' => 'Ошибка API: ' . $body];
    }

    return json_decode($body, true);
}

Эта функция отправляет запрос на создание заказа и возвращает ответ или ошибку.

Обработка ошибок и валидация данных заказа

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

Рекомендуется:

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

Пример простой валидации перед вызовом функции создания заказа:

function wporder_validate_order_data($data) {
    if (empty($data['billing']['email']) || !filter_var($data['billing']['email'], FILTER_VALIDATE_EMAIL)) {
        return 'Неверный email покупателя';
    }
    if (empty($data['line_items']) || !is_array($data['line_items'])) {
        return 'Заказ должен содержать хотя бы один товар';
    }
    // Можно добавить другие проверки
    return true;
}

Использование плагинов для упрощения интеграции

Если нужно интегрировать магазин с внешними сервисами и не хочется писать всю логику с нуля, обратите внимание на плагины:

WooCommerce REST API Manager — расширяет возможности стандартного API, добавляет удобный интерфейс для управления ключами и правами.
WPGPT — с помощью ИИ можно автоматически формировать описания заказов и дополнительные поля.

Использование этих инструментов поможет ускорить разработку и повысить надёжность интеграции.

Заключение: лучшие практики автоматизации заказов через REST API

Автоматическое создание заказов через REST API — мощный инструмент для расширения функциональности вашего WordPress-магазина. Чтобы сделать интеграцию устойчивой и безопасной, придерживайтесь следующих рекомендаций:

Используйте защищённые ключи API с минимально необходимыми правами.
Валидация и тщательная обработка данных до отправки запроса.
Обработка ошибок и логирование для оперативного реагирования.
Тестируйте интеграцию на тестовом сайте перед запуском в продакшн.

Следуя этим советам, вы сможете эффективно автоматизировать создание заказов и интегрировать магазин с любыми внешними системами.