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

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

Введение в REST API WordPress и его возможности для тикет-систем

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

Для начала стоит понять, что в основе тикет-системы лежат кастомные типы записей (Custom Post Types), к которым мы добавим REST API поддержку. Это позволит работать с тикетами через HTTP-запросы, используя стандартные методы GET, POST, PUT, DELETE.

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

Создание кастомного типа записи «ticket» с поддержкой REST API

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

function wpticket_register_ticket_cpt() {
  $args = array(
    'labels' => array(
      'name' => 'Тикеты',
      'singular_name' => 'Тикет',
    ),
    'public' => true,
    'has_archive' => true,
    'show_in_rest' => true, // Включаем REST API
    'supports' => array('title', 'editor', 'author', 'comments'),
    'capability_type' => 'post',
  );
  register_post_type('ticket', $args);
}
add_action('init', 'wpticket_register_ticket_cpt');

Этот код регистрирует новый тип записи ticket. Теперь можно создавать тикеты в админке и обращаться к ним через REST API. Например, GET-запрос на /wp-json/wp/v2/ticket вернёт список тикетов.

Добавление пользовательских полей для тикетов

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

function wpticket_register_ticket_meta() {
  register_post_meta('ticket', 'wpticket_status', array(
    'show_in_rest' => true,
    'single' => true,
    'type' => 'string',
    'default' => 'new',
  ));
  register_post_meta('ticket', 'wpticket_priority', array(
    'show_in_rest' => true,
    'single' => true,
    'type' => 'string',
    'default' => 'normal',
  ));
}
add_action('init', 'wpticket_register_ticket_meta');

Теперь при создании или обновлении тикета через REST API можно указывать статус и приоритет. Например, в JSON-запросе:

{
  "title": "Проблема с сайтом",
  "content": "Описание проблемы",
  "wpticket_status": "open",
  "wpticket_priority": "high"
}

Пример создания тикета через REST API с помощью wp_remote_post

Для взаимодействия с REST API из PHP можно использовать функцию wp_remote_post. Вот пример создания тикета программно:

$response = wp_remote_post(rest_url('wp/v2/ticket'), array(
  'headers' => array(
    'Authorization' => 'Bearer ' . $access_token, // токен авторизации
    'Content-Type' => 'application/json',
  ),
  'body' => json_encode(array(
    'title' => 'Новый тикет',
    'content' => 'Описание проблемы',
    'wpticket_status' => 'new',
    'wpticket_priority' => 'normal',
  )),
));
if (is_wp_error($response)) {
  // обработка ошибки
} else {
  $body = json_decode(wp_remote_retrieve_body($response));
  // Работа с ответом
}

Обратите внимание, что для работы с REST API в режиме авторизации желательно использовать JWT или OAuth, чтобы обеспечить безопасность операций.

Использование плагинов для расширения функционала тикет-системы

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

WP Support Plus Responsive Ticket System — удобный плагин с интерфейсом для пользователей и поддержкой кастомизации.
Awesome Support — расширяемая тикет-система с множеством дополнительных модулей.
WP REST API Controller — позволяет гибко настраивать доступ к REST API, что пригодится для ограничения прав на создание и редактирование тикетов.

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

Создание кастомных REST API эндпоинтов для специфичных задач тикет-системы

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

Для этого создаём собственные маршруты и обработчики:

function wpticket_register_custom_routes() {
  register_rest_route('wpticket/v1', '/bulk-update-status', array(
    'methods' => 'POST',
    'callback' => 'wpticket_bulk_update_status',
    'permission_callback' => function () {
      return current_user_can('edit_posts');
    },
  ));
}
add_action('rest_api_init', 'wpticket_register_custom_routes');

function wpticket_bulk_update_status(WP_REST_Request $request) {
  $tickets = $request->get_param('tickets'); // массив ID тикетов
  $status = $request->get_param('status');

  if (empty($tickets) || empty($status)) {
    return new WP_Error('invalid_data', 'Не переданы необходимые параметры', array('status' => 400));
  }

  foreach ($tickets as $ticket_id) {
    update_post_meta($ticket_id, 'wpticket_status', sanitize_text_field($status));
  }

  return array('updated' => count($tickets));
}

Такой эндпоинт позволит за один запрос массово менять статус тикетов, что удобно для администраторов.

Выводы по созданию простой тикет-системы на WordPress с REST API

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