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

Метод 1. Регистрация пользовательского маршрута REST
Первый метод включает регистрацию пользовательского маршрута REST с помощью функции register_rest_route(). Этот метод позволяет вам определить маршрут, указать поддерживаемые им методы HTTP и связать его с функцией обратного вызова, которая обрабатывает запрос и возвращает ответ. Вот пример:

function custom_endpoint_callback(WP_REST_Request $request) {
    // Handle the request and build the response
    $data = array(
        'message' => 'Hello, World!'
    );
    return new WP_REST_Response($data, 200);
}
add_action('rest_api_init', function () {
    register_rest_route('myplugin/v1', '/custom-endpoint', array(
        'methods' => 'GET',
        'callback' => 'custom_endpoint_callback',
    ));
});

Метод 2: создание пользовательского класса для конечных точек
Другой подход — создать собственный класс, который инкапсулирует логику вашей конечной точки. Этот метод обеспечивает лучшую организацию и разделение задач, особенно при работе с несколькими конечными точками. Вот пример:

class Custom_Endpoint_Controller extends WP_REST_Controller {
    public function register_routes() {
        $version = '1';
        $namespace = 'myplugin/v' . $version;
        $base = '/custom-endpoint';
        register_rest_route($namespace, $base, array(
            array(
                'methods' => 'GET',
                'callback' => array($this, 'get_custom_endpoint'),
            ),
        ));
    }
    public function get_custom_endpoint(WP_REST_Request $request) {
        // Handle the request and build the response
        $data = array(
            'message' => 'Hello, World!'
        );
        return new WP_REST_Response($data, 200);
    }
}
add_action('rest_api_init', function () {
    $controller = new Custom_Endpoint_Controller();
    $controller->register_routes();
});

Метод 3. Защита пользовательских конечных точек
При создании пользовательских конечных точек крайне важно обеспечить их безопасность и доступность только авторизованным пользователям. WordPress предоставляет встроенные проверки аутентификации и разрешений, которые можно добавить к обратным вызовам конечной точки. Вот пример защиты пользовательской конечной точки с помощью аутентификации пользователя:

function custom_authenticated_endpoint_callback(WP_REST_Request $request) {
    if (!is_user_logged_in()) {
        return new WP_Error('rest_not_logged_in', 'You are not authenticated.', array('status' => 401));
    }
// Handle the request and build the response
    $data = array(
        'message' => 'Hello, ' . wp_get_current_user()->user_login
    );
    return new WP_REST_Response($data, 200);
}
add_action('rest_api_init', function () {
    register_rest_route('myplugin/v1', '/custom-auth-endpoint', array(
        'methods' => 'GET',
        'callback' => 'custom_authenticated_endpoint_callback',
        'permission_callback' => 'is_user_logged_in',
    ));
});

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