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

Автор: Марина Данилова | Опубликовано: 28.03.2026

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

Что такое REST API в WordPress и зачем он нужен для управления пользователями

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

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

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

Как получить список пользователей через REST API WordPress

Для получения списка пользователей используется стандартный endpoint:

GET /wp-json/wp/v2/users

Однако по умолчанию этот запрос доступен только аутентифицированным пользователям с правами администратора. Для выполнения запроса необходимо использовать авторизацию через куки или OAuth, Basic Auth и другие методы.

Пример запроса на PHP с использованием Basic Auth:

$response = wp_remote_get('https://example.com/wp-json/wp/v2/users', [
    'headers' => [
        'Authorization' => 'Basic ' . base64_encode('username:password')
    ]
]);

$body = wp_remote_retrieve_body($response);
$users = json_decode($body);
print_r($users);

Фильтрация и пагинация пользователей

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

GET /wp-json/wp/v2/users?per_page=10&page=2&roles=editor

Это позволит получить вторую страницу по 10 пользователей с ролью редактора.

Создание и обновление пользователей через REST API

Чтобы создать пользователя, отправьте POST-запрос на тот же endpoint с необходимыми полями:

POST /wp-json/wp/v2/users

Обязательные поля — username, email, password. Пример тела запроса в JSON:

{
  "username": "noviy_user",
  "email": "user@example.com",
  "password": "securePass123"
}

Для обновления пользователя используйте метод PUT или PATCH по адресу /wp-json/wp/v2/users/{id} с нужными полями.

Пример обновления email пользователя с id 5:

PATCH /wp-json/wp/v2/users/5
{
  "email": "newemail@example.com"
}

Обеспечение безопасности при управлении пользователями

Управление пользователями через REST API требует строгой авторизации. Без неё вы рискуете открыть доступ злоумышленникам. Используйте nonce, OAuth, JWT или Basic Auth с HTTPS. Также можно ограничить доступ к endpoint'ам по IP.

Расширение REST API для кастомных операций с пользователями

Стандартный API не всегда покрывает все бизнес-задачи. Можно добавить свои endpoint'ы с помощью хука rest_api_init. Пример создания endpoint для сброса пароля пользователя:

add_action('rest_api_init', function () {
    register_rest_route('wplite/v1', '/reset-password/(?P<id>\d+)', [
        'methods' => 'POST',
        'callback' => 'wplite_reset_password',
        'permission_callback' => function () {
            return current_user_can('edit_users');
        }
    ]);
});

function wplite_reset_password(WP_REST_Request $request) {
    $user_id = $request->get_param('id');
    $new_password = wp_generate_password();
    wp_set_password($new_password, $user_id);
    return ['message' => 'Пароль успешно сброшен', 'new_password' => $new_password];
}

Такой подход позволяет создавать собственные API для специфичных задач.

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

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

WP User REST API — расширяет стандартные endpoint'ы, добавляет дополнительные поля и функции.
JWT Authentication for WP REST API — добавляет поддержку JWT-токенов для безопасной авторизации.
WP REST User — удобный плагин для управления пользователями через REST API с расширенными возможностями.

Все эти плагины доступны на wpshop.ru с удобной установкой и поддержкой.

Практические советы и рекомендации

При интеграции REST API для управления пользователями учитывайте следующие моменты:

Обязательно используйте HTTPS для защиты данных.
Не передавайте пароли в открытом виде без шифрования.
Ограничьте права доступа к пользовательским данным.
Используйте nonce для защиты от CSRF-атак.
Проверяйте и валидируйте все входящие данные.

Кроме того, рекомендуем протестировать API с помощью инструментов Postman или Curl для отладки.

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

Ниже пример JavaScript кода, который создаёт пользователя через REST API с использованием nonce:

jQuery(document).ready(function($) {
    $('#create-user-form').on('submit', function(e) {
        e.preventDefault();
        var data = {
            username: $('#username').val(),
            email: $('#email').val(),
            password: $('#password').val()
        };
        $.ajax({
            url: wpApiSettings.root + 'wp/v2/users',
            method: 'POST',
            beforeSend: function(xhr) {
                xhr.setRequestHeader('X-WP-Nonce', wpApiSettings.nonce);
            },
            data: data
        }).done(function(response) {
            alert('Пользователь создан: ' + response.username);
        }).fail(function(response) {
            alert('Ошибка: ' + response.responseJSON.message);
        });
    });
});

Для работы этого примера в теме нужно локализовать скрипт с nonce и URL REST API.