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

Автор: Юлия Журавлева | Опубликовано: 03.12.2025

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

Что такое REST API в WordPress и зачем он нужен?

REST API (Representational State Transfer Application Programming Interface) даёт возможность внешним приложениям и фронтенду взаимодействовать с сайтом WordPress через HTTP-запросы. Это значит, что вы можете не только получать данные, но и создавать, обновлять, удалять записи, пользователей и другие сущности WordPress программно и удалённо.

Для бизнес-проектов это открывает такие возможности, как:

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

WordPress начиная с версии 4.7 имеет встроенный REST API с базовыми эндпоинтами для постов, страниц, пользователей и так далее.

Регистрация собственного REST API эндпоинта для бизнес-задач

Чтобы расширить возможности стандартного API и адаптировать его под конкретные задачи, часто необходимо создавать собственные эндпоинты. Рассмотрим, как это сделать на примере регистрации простого эндпоинта, который возвращает список последних заказов (предположим, что у вас есть кастомный post type order).

Добавьте следующий код в файл плагина или functions.php вашей темы:

add_action('rest_api_init', 'wpbusiness_register_orders_endpoint');
function wpbusiness_register_orders_endpoint() {
    register_rest_route('wpbusiness/v1', '/orders', array(
        'methods' => 'GET',
        'callback' => 'wpbusiness_get_orders',
        'permission_callback' => function () {
            return current_user_can('read');
        }
    ));
}

function wpbusiness_get_orders(WP_REST_Request $request) {
    $args = array(
        'post_type' => 'order',
        'post_status' => 'publish',
        'numberposts' => 10
    );
    $orders = get_posts($args);
    $data = array();
    foreach ($orders as $order) {
        $data[] = array(
            'id' => $order->ID,
            'title' => $order->post_title,
            'date' => $order->post_date
        );
    }
    return rest_ensure_response($data);
}

Этот код создаёт новый API маршрут /wp-json/wpbusiness/v1/orders, который возвращает массив последних десяти заказов. Обратите внимание на permission_callback, который ограничивает доступ только авторизованным пользователям с правом читать контент.

Пояснения по коду

Функция register_rest_route принимает три параметра: пространство имён («wpbusiness/v1»), URL маршрута («/orders») и массив настроек, где указывается HTTP метод, функция-обработчик и проверка прав доступа.

Обработчик wpbusiness_get_orders собирает данные из базы через стандартные WP функции и возвращает их в формате JSON.

Пример POST-запроса для создания записи через REST API

Если вы хотите создавать записи через API, например, добавлять новые заказы, можно зарегистрировать эндпоинт с методом POST. Ниже пример для создания нового заказа:

add_action('rest_api_init', 'wpbusiness_register_create_order_endpoint');
function wpbusiness_register_create_order_endpoint() {
    register_rest_route('wpbusiness/v1', '/orders', array(
        'methods' => 'POST',
        'callback' => 'wpbusiness_create_order',
        'permission_callback' => function () {
            return current_user_can('edit_posts');
        }
    ));
}

function wpbusiness_create_order(WP_REST_Request $request) {
    $params = $request->get_json_params();
    if (empty($params['title'])) {
        return new WP_Error('no_title', 'Отсутствует заголовок заказа', array('status' => 400));
    }

    $new_order = array(
        'post_title' => sanitize_text_field($params['title']),
        'post_type' => 'order',
        'post_status' => 'publish'
    );

    $order_id = wp_insert_post($new_order);
    if (is_wp_error($order_id)) {
        return $order_id;
    }

    return rest_ensure_response(array('order_id' => $order_id));
}

Этот код ожидает JSON с параметром title и создаёт новый заказ. Ошибки обрабатываются через объект WP_Error.

Авторизация и безопасность работы с REST API

При работе с REST API важно обеспечить безопасность и контроль доступа. Встроенный WordPress API поддерживает несколько способов авторизации:

Куки авторизации (для запросов из браузера, где пользователь уже вошёл в систему).
Basic Authentication (удобна для тестов, но не рекомендуема для продакшена без HTTPS).
OAuth и JWT (лучше подходит для мобильных и внешних приложений).

Для бизнес-проектов с внешними приложениями рекомендуется использовать JWT (JSON Web Token). Существуют популярные плагины, например JWT Authentication for WP REST API, которые позволяют реализовать этот способ.

Пример работы с JWT:

Клиент отправляет POST-запрос на /wp-json/jwt-auth/v1/token с логином и паролем.
Получает токен и использует его в заголовке Authorization: Bearer <token> для последующих запросов.

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

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

WP REST API Controller – позволяет управлять доступом и видимостью стандартных эндпоинтов без кода.
Advanced Custom Fields (ACF) to REST API – добавляет поля ACF в ответы API.
JWT Authentication for WP REST API – реализует безопасную авторизацию через JWT.
WPGraphQL – если хотите использовать GraphQL вместо REST.

Практические советы для эффективного использования REST API в бизнес-проектах на WordPress

Работая с REST API, обращайте внимание на следующие моменты:

Кэширование ответов. Для снижения нагрузки используйте плагины кэширования или собственные решения, например, кэширование ответов эндпоинтов с помощью Transients API.
Валидация и санитизация данных. Всегда проверяйте входящие данные, чтобы избежать уязвимостей и ошибок в базе.
Разграничение прав доступа. Определяйте, кому и что разрешено делать через API, чтобы защитить чувствительную информацию.
Логирование запросов. Для отладки и мониторинга полезно вести журнал обращения к вашим эндпоинтам.
Документирование API. Создайте описание ваших кастомных маршрутов, чтобы команда разработки или сторонние разработчики могли легко работать с вашим API.

Заключение: REST API как ключ к масштабируемости и гибкости бизнес-сайта на WordPress

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

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

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