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

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

Что такое микросервисы и зачем они нужны в WordPress

Микросервисы — это архитектурный подход, при котором приложение разбивается на независимые сервисы, каждый из которых выполняет конкретную функцию и общается с другими через API. В контексте WordPress это позволяет:

• Изолировать бизнес-логику в отдельные сервисы.
• Обеспечить масштабируемость и гибкость.
• Интегрировать WordPress с другими системами через стандартизированные интерфейсы.

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

Создание собственного REST API эндпоинта в WordPress

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

add_action('rest_api_init', 'wpsolution_register_custom_endpoint');
function wpsolution_register_custom_endpoint() {
    register_rest_route('wpsolution/v1', '/latest-posts/', array(
        'methods' => 'GET',
        'callback' => 'wpsolution_get_latest_posts',
        'permission_callback' => '__return_true',
    ));
}

function wpsolution_get_latest_posts(WP_REST_Request $request) {
    $args = array(
        'post_type' => 'post',
        'posts_per_page' => 5,
        'post_status' => 'publish',
    );
    $query = new WP_Query($args);
    $posts = array();
    if ($query->have_posts()) {
        while ($query->have_posts()) {
            $query->the_post();
            $posts[] = array(
                'id' => get_the_ID(),
                'title' => get_the_title(),
                'link' => get_permalink(),
            );
        }
        wp_reset_postdata();
    }
    return rest_ensure_response($posts);
}

Данный код регистрирует маршрут /wp-json/wpsolution/v1/latest-posts/, по которому можно получить JSON с последними 5 опубликованными записями. Это первый шаг к созданию микросервиса, который предоставляет данные другим системам.

Обработка POST-запросов: создание микросервиса для приема данных

Микросервисы часто должны принимать данные и обрабатывать их. Например, можно создать REST API endpoint, который будет принимать форму обратной связи и сохранять сообщения в отдельный тип записей.

Сначала создадим CPT для хранения сообщений:

add_action('init', 'wpsolution_register_feedback_cpt');
function wpsolution_register_feedback_cpt() {
    register_post_type('feedback', array(
        'label' => 'Обратная связь',
        'public' => false,
        'show_ui' => true,
        'supports' => array('title', 'editor'),
    ));
}

Теперь создадим REST API endpoint для приёма данных:

add_action('rest_api_init', 'wpsolution_register_feedback_endpoint');
function wpsolution_register_feedback_endpoint() {
    register_rest_route('wpsolution/v1', '/feedback/', array(
        'methods' => 'POST',
        'callback' => 'wpsolution_handle_feedback',
        'permission_callback' => '__return_true',
    ));
}

function wpsolution_handle_feedback(WP_REST_Request $request) {
    $params = $request->get_json_params();
    if (empty($params['name']) || empty($params['message'])) {
        return new WP_Error('invalid_data', 'Необходимо указать имя и сообщение', array('status' => 400));
    }

    $post_id = wp_insert_post(array(
        'post_type' => 'feedback',
        'post_title' => sanitize_text_field($params['name']),
        'post_content' => sanitize_textarea_field($params['message']),
        'post_status' => 'publish',
    ));

    if (is_wp_error($post_id)) {
        return new WP_Error('insert_failed', 'Ошибка при сохранении сообщения', array('status' => 500));
    }

    return rest_ensure_response(array('success' => true, 'id' => $post_id));
}

Теперь можно отправлять POST-запросы с JSON вида:

{
  "name": "Иван Иванов",
  "message": "Спасибо за отличный сайт!"
}

и получать ответ с ID созданного сообщения.

Аутентификация и безопасность REST API микросервисов

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

• Куки и nonce — подходят для взаимодействия с фронтендом сайта.
• Basic Auth — простой, но менее безопасный способ, подходит для тестирования.
• OAuth — более сложный, но безопасный метод для внешних приложений.
• JWT (JSON Web Token) — популярный и современный способ аутентификации.

Для примера рассмотрим добавление простейшей проверки ключа API в запросах:

function wpsolution_permission_callback(WP_REST_Request $request) {
    $api_key = $request->get_header('X-API-KEY');
    $valid_key = 'ваш_секретный_ключ';
    if ($api_key !== $valid_key) {
        return new WP_Error('forbidden', 'Недостаточно прав', array('status' => 403));
    }
    return true;
}

// Используем в register_rest_route вместо '__return_true'
register_rest_route('wpsolution/v1', '/secure-data/', array(
    'methods' => 'GET',
    'callback' => 'wpsolution_get_secure_data',
    'permission_callback' => 'wpsolution_permission_callback',
));

Такой подход позволяет ограничить доступ к микросервисам только тем, кто имеет ключ API.

Интеграция с плагинами WPSHOP и примеры расширения микросервисов

Плагины из экосистемы WPSHOP, например, WPRemark, позволяют расширять функционал оценки и анализа контента. Например, можно создать микросервис, который будет принимать ID статьи и возвращать оценку качества контента, используя WPRemark API.

Также полезным будет плагин Clearfy Pro для оптимизации работы REST API и отключения ненужных эндпоинтов, что повысит безопасность и производительность.

Для расширения микросервисов можно создавать более сложные маршруты с параметрами, фильтрами и пагинацией, добавлять обработку пользовательских ролей и прав, а также интегрировать с внешними сервисами через HTTP-запросы изнутри WordPress.

Пример расширенного микросервиса с параметрами и пагинацией

Давайте усложним наш первый пример и добавим возможность указывать тип записи и количество элементов через параметры GET:

add_action('rest_api_init', 'wpsolution_register_advanced_endpoint');
function wpsolution_register_advanced_endpoint() {
    register_rest_route('wpsolution/v1', '/posts/', array(
        'methods' => 'GET',
        'callback' => 'wpsolution_get_posts_with_params',
        'permission_callback' => '__return_true',
        'args' => array(
            'post_type' => array(
                'required' => false,
                'default' => 'post',
                'sanitize_callback' => 'sanitize_text_field',
            ),
            'per_page' => array(
                'required' => false,
                'default' => 5,
                'sanitize_callback' => 'absint',
            ),
            'page' => array(
                'required' => false,
                'default' => 1,
                'sanitize_callback' => 'absint',
            ),
        ),
    ));
}

function wpsolution_get_posts_with_params(WP_REST_Request $request) {
    $post_type = $request->get_param('post_type');
    $per_page = $request->get_param('per_page');
    $page = $request->get_param('page');

    $args = array(
        'post_type' => $post_type,
        'posts_per_page' => $per_page,
        'paged' => $page,
        'post_status' => 'publish',
    );

    $query = new WP_Query($args);
    $posts = array();
    if ($query->have_posts()) {
        while ($query->have_posts()) {
            $query->the_post();
            $posts[] = array(
                'id' => get_the_ID(),
                'title' => get_the_title(),
                'link' => get_permalink(),
            );
        }
        wp_reset_postdata();
    }

    $response = array(
        'posts' => $posts,
        'total' => (int) $query->found_posts,
        'pages' => (int) $query->max_num_pages,
    );

    return rest_ensure_response($response);
}

Теперь запрос /wp-json/wpsolution/v1/posts/?post_type=feedback&per_page=10&page=2 вернёт вторую страницу с 10 записями типа feedback.

Выводы и рекомендации по созданию микросервисов в WordPress

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

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

• Использовать namespace и версии в маршрутах для удобства поддержки.
• Контролировать права доступа через permission_callback.
• Санитизировать и валидировать все входящие данные.
• Использовать существующие плагины из экосистемы WPSHOP для расширения функционала.

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