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

Автор: Максим Захаров | Опубликовано: 14.11.2025

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

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

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

Преимущества использования REST API:

Удалённое управление настройками и контентом;
Создание кастомных интерфейсов и мобильных приложений;
Обеспечение безопасности и контроля доступа через аутентификацию;
Гибкость и расширяемость без необходимости напрямую работать с административной панелью.

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

Создание пользовательского REST API эндпоинта для настроек WordPress

Регистрация маршрута REST API

Первый шаг — зарегистрировать собственный маршрут (endpoint), который будет обрабатывать запросы к пользовательским настройкам. Для этого используем функцию register_rest_route(), которую подключаем на хук rest_api_init. Вот пример кода, который можно добавить в файл плагина или functions.php темы:

add_action('rest_api_init', 'wpbegin_register_settings_endpoint');
function wpbegin_register_settings_endpoint() {
    register_rest_route('wpbegin/v1', '/settings', array(
        'methods' => 'GET',
        'callback' => 'wpbegin_get_settings',
        'permission_callback' => function () {
            return current_user_can('manage_options');
        }
    ));

    register_rest_route('wpbegin/v1', '/settings', array(
        'methods' => 'POST',
        'callback' => 'wpbegin_update_settings',
        'permission_callback' => function () {
            return current_user_can('manage_options');
        }
    ));
}

В этом примере мы создаём два маршрута для одного URL /wp-json/wpbegin/v1/settings: GET - для получения текущих настроек, POST - для их обновления. Обратите внимание на permission_callback, который проверяет, что запрос выполняет пользователь с правами администратора.

Обработка получения настроек

Далее реализуем функцию для получения настроек. Предположим, у нас есть несколько опций, сохранённых через update_option. Пример функции:

function wpbegin_get_settings( WP_REST_Request $request ) {
    $settings = array(
        'site_mode' => get_option('wpbegin_site_mode', 'production'),
        'items_per_page' => (int) get_option('wpbegin_items_per_page', 10),
        'enable_feature_x' => (bool) get_option('wpbegin_enable_feature_x', false),
    );

    return rest_ensure_response($settings);
}

Функция возвращает массив с текущими настройками. Их можно расширять под конкретные задачи.

Обработка обновления настроек

Для обновления настроек создадим функцию, которая проверит переданные данные, валидирует их и сохранит через update_option:

function wpbegin_update_settings( WP_REST_Request $request ) {
    $params = $request->get_json_params();

    if (empty($params) || !is_array($params)) {
        return new WP_Error('invalid_data', 'Нет данных для обновления', array('status' => 400));
    }

    // Валидация и фильтрация данных
    $site_mode = isset($params['site_mode']) && in_array($params['site_mode'], ['production', 'development']) ? $params['site_mode'] : 'production';
    $items_per_page = isset($params['items_per_page']) ? intval($params['items_per_page']) : 10;
    $enable_feature_x = isset($params['enable_feature_x']) ? (bool) $params['enable_feature_x'] : false;

    // Сохранение настроек
    update_option('wpbegin_site_mode', $site_mode);
    update_option('wpbegin_items_per_page', $items_per_page);
    update_option('wpbegin_enable_feature_x', $enable_feature_x);

    return rest_ensure_response(array('success' => true, 'message' => 'Настройки обновлены')); 
}

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

Практические примеры использования REST API для настроек

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

REST API позволяет создавать мобильные приложения или SPA (single-page applications), которые будут управлять настройками сайта WordPress без необходимости заходить в админку. Например, можно создать React-приложение, которое через AJAX будет обращаться к эндпоинтам /wp-json/wpbegin/v1/settings и получать или изменять настройки.

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

Расширение функционала плагинов и тем

Если вы разрабатываете плагин или тему с дополнительными настройками, REST API — это удобный способ дать доступ к этим настройкам при помощи внешних интерфейсов или AJAX-запросов. Это особенно актуально для кастомных административных панелей или интеграций с другими сервисами.

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

При создании собственных маршрутов REST API важно помнить о безопасности:

Всегда используйте permission_callback для проверки прав пользователя.
Проводите валидацию и фильтрацию входящих данных.
Ограничивайте методы, которые доступны на эндпоинте.
Используйте безопасные методы аутентификации (OAuth, JWT, куки).
При необходимости логируйте запросы для отслеживания подозрительной активности.

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

Заключение: REST API как инструмент для расширения WordPress

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

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