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

Автор: Ирина Ковалева | Опубликовано: 13.11.2025

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

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

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

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

Возможность создавать одностраничные приложения (SPA) на React, Vue или Angular, используя WordPress как backend.
Интеграция с мобильными приложениями, которые могут получать и отправлять данные на сайт.
Автоматизация задач и создание кастомных инструментов для управления контентом.
Расширение функциональности без необходимости прямого доступа к базе данных.

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

Основные эндпоинты REST API WordPress

WordPress предоставляет стандартные маршруты, которые позволяют работать с типами записей, таксономиями, пользователями и другими объектами. Пример базового эндпоинта для получения списка публикаций:

https://wpone.ru/wp-json/wp/v2/posts

Этот запрос вернёт список последних постов в формате JSON. Аналогично доступны маршруты для страниц (/wp-json/wp/v2/pages), категорий, тегов и пр.

Для получения конкретного поста нужно указать его ID:

https://wpone.ru/wp-json/wp/v2/posts/123

Можно фильтровать записи по параметрам, например, по категории или автору:

https://wpone.ru/wp-json/wp/v2/posts?categories=5&author=2

Это позволяет гибко получать нужные данные без создания собственных SQL-запросов.

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

Можно создать простой скрипт, который загрузит и отобразит последние записи в блоке страницы:

document.addEventListener('DOMContentLoaded', function() {
  fetch('https://wpone.ru/wp-json/wp/v2/posts?per_page=5')
    .then(response => response.json())
    .then(posts => {
      const container = document.getElementById('posts-container');
      posts.forEach(post => {
        const postEl = document.createElement('article');
        postEl.innerHTML = `<h2>${post.title.rendered}</h2><div>${post.excerpt.rendered}</div>`;
        container.appendChild(postEl);
      });
    })
    .catch(error => console.error('Ошибка загрузки постов:', error));
});

В HTML страницы достаточно добавить контейнер с id="posts-container", и скрипт автоматически подгрузит последние записи.

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

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

Рассмотрим пример, как добавить свой маршрут, который возвращает список последних заказов (например, для WooCommerce):

add_action('rest_api_init', function () {
  register_rest_route('wpone/v1', '/orders', array(
    'methods' => 'GET',
    'callback' => 'wpone_get_orders',
    'permission_callback' => function () {
      return current_user_can('manage_woocommerce');
    }
  ));
});

function wpone_get_orders(WP_REST_Request $request) {
  $args = array(
    'limit' => 10,
    'orderby' => 'date',
    'order' => 'DESC'
  );
  $orders = wc_get_orders($args);
  $data = array();
  foreach ($orders as $order) {
    $data[] = array(
      'id' => $order->get_id(),
      'total' => $order->get_total(),
      'status' => $order->get_status(),
      'date' => $order->get_date_created()->date('Y-m-d H:i:s')
    );
  }
  return rest_ensure_response($data);
}

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

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

Пример создания собственного POST-запроса для добавления новой записи в кастомном типе постов wpone_note:

add_action('rest_api_init', function () {
  register_rest_route('wpone/v1', '/notes', array(
    'methods' => 'POST',
    'callback' => 'wpone_create_note',
    'permission_callback' => function () {
      return is_user_logged_in();
    }
  ));
});

function wpone_create_note(WP_REST_Request $request) {
  $params = $request->get_json_params();
  $title = sanitize_text_field($params['title'] ?? '');
  $content = sanitize_textarea_field($params['content'] ?? '');

  if (empty($title) || empty($content)) {
    return new WP_Error('wpone_empty_fields', 'Заголовок и содержимое обязательны', array('status' => 400));
  }

  $post_id = wp_insert_post(array(
    'post_title' => $title,
    'post_content' => $content,
    'post_status' => 'publish',
    'post_type' => 'wpone_note'
  ));

  if (is_wp_error($post_id)) {
    return $post_id;
  }

  return rest_ensure_response(array('id' => $post_id, 'message' => 'Заметка создана успешно'));
}

Такой эндпоинт позволяет клиентам отправлять POST-запросы с JSON-телом, чтобы создавать новые заметки. Это полезно для мобильных приложений или внешних сервисов, которые хотят интегрироваться с вашим сайтом.

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

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

WP REST API Controller — позволяет управлять доступом к разным типам записей, полям и таксономиям через удобный интерфейс.
Advanced Custom Fields to REST API — добавляет поддержку полей ACF в ответы REST API, что облегчает работу с кастомными данными.
JWT Authentication for WP REST API — реализует JSON Web Token аутентификацию для защищённого доступа к закрытым эндпоинтам.

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

Пример интеграции ACF полей в REST API

После установки и активации плагина ACF to REST API кастомные поля автоматически становятся доступны в ответах. Например, если у поста есть поле rating, оно появится в JSON:

{
  "id": 123,
  "title": {"rendered": "Заголовок записи"},
  "acf": {
    "rating": 4.5
  }
}

Это значительно упрощает разработку фронтенда с использованием динамических данных.

Безопасность и ограничения при работе с REST API

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

Рекомендации по безопасности:

Используйте permission_callback при регистрации собственных маршрутов для контроля доступа.
При необходимости ограничивайте данные, которые возвращаете, скрывайте конфиденциальные поля.
Для аутентификации используйте OAuth, JWT или классическую cookie-сессию WordPress.
Обновляйте WordPress и плагины, чтобы использовать последние исправления безопасности.

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

add_filter('rest_authentication_errors', function($result) {
  if (!empty($result)) {
    return $result;
  }
  if (!is_user_logged_in()) {
    return new WP_Error('rest_forbidden', 'Доступ запрещён', array('status' => 401));
  }
  return $result;
});

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

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

Для эффективной работы с REST API советую:

Освоить стандартные маршруты и возможности WordPress.
Научиться создавать собственные эндпоинты с учётом безопасности.
Использовать проверенные плагины для расширения функционала.
Тестировать API с помощью инструментов типа Postman или curl.

И, конечно, всегда контролировать права доступа и защищать свои данные.