Работа с REST API

{ "title": "Работа с REST API в WordPress: пошаговое практическое руководство", "keywords": "REST API WordPress, работа с REST API, WordPress REST API примеры, создание API запросов WordPress, обучение REST API WordPress, веб-разработка REST API, CMS WordPress API", "description": "Пошаговое руководство по работе с REST API в WordPress: от аутентификации до создания кастомных маршрутов. Практические примеры, инструменты, типичные ошибки и их решение.", "html_content": "

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

\n\n

Экономия времени: вместо ручного создания REST-эндпоинтов вы используете готовые маршруты WordPress, сокращая разработку в 2–3 раза.
Избегание типовых ошибок: настройка аутентификации через JWT или OAuth правильным образом — без этого 90% запросов вернут 401 ошибку.
Реальные кейсы: примеры с конкретными URL, параметрами и ответами — вы сможете сразу скопировать и протестировать каждый шаг.

\n\n

REST API в WordPress предоставляет доступ к 20+ основным типам данных: посты, страницы, медиафайлы, пользователи, таксономии, комментарии и настройки. Каждый эндпоинт поддерживает фильтрацию, пагинацию и сортировку. Отличие данной площадки — фокус на практику: вы не просто читаете теорию, а сразу применяете знания на реальном демо-сайте, развёрнутом специально для курса.

\n\n

Полный контроль данных: работа через JSON позволяет получать только нужные поля, сокращая размер ответа до 70% по сравнению с HTML-страницей.
Готовая документация: все маршруты описаны в официальном справочнике, но в курсе мы даём сжатые шпаргалки для быстрого доступа.
Безопасность из коробки: правильная настройка nonce и CORS — минимум 2 часа экономии на отладке.

\n\n

Работа с REST API требует не только знания теории, но и умения выбирать правильные инструменты и методы. Ниже — пошаговое руководство, которое проведёт вас от первого запроса до создания кастомного маршрута с аутентификацией. Каждый шаг включает конкретные команды, примеры кода и ожидаемый результат, чтобы вы могли сразу проверить свою работу.

\n\n

Шаг 1. Подготовка окружения и базовый запрос к API

Установите инструмент для тестирования запросов. Рекомендуем Postman (бесплатная версия) или расширение для браузера RESTED. Убедитесь, что версия Postman не ниже 10.0 — в более старых версиях нет поддержки автоматической подстановки заголовков для WordPress nonce.
Получите ссылку на ваш сайт WordPress. Используйте демо-сайт курса (адрес выдаётся при регистрации) или локальную установку. Убедитесь, что включена постоянная ссылка (Pretty Permalinks) — без неё эндпоинты не работают. Проверить: Settings → Permalinks → выберите любой вариант, кроме Plain.
Выполните базовый GET-запрос: откройте в инструменте URL https://ваш-сайт/wp-json/wp/v2/posts. Ожидаемый ответ — JSON-массив с 10 последними постами (по умолчанию). Если получаете HTML или пустое тело — проверьте наличие аддона REST API (должен быть включен по умолчанию с версии WP 4.7).
Добавьте параметры фильтрации: ?per_page=20&orderby=title&_fields=id,title,link. Это вернёт 20 постов, отсортированных по заголовку, только ID, заголовок и ссылку. Экономия трафика — до 60% по сравнению с полным ответом.
Проанализируйте структуру ответа. Обратите внимание на поля: id, title.rendered, content.rendered (с HTML), _links — ссылки для пагинации и связанных данных. Запомните: для получения чистого текста без HTML используете _fields и excerpt.rendered.
Проверьте обработку ошибок. Сделайте запрос на несуществующий эндпоинт /wp-json/wp/v2/nonexist. Ожидайте ответ с HTTP-кодом 404 и JSON-объектом: {'code':'rest_no_route','message':'No route was found matching the URL and request method'}.
Сохраните рабочую коллекцию в Postman. Экспортируйте её в JSON-файл — она понадобится для следующих шагов. Имя файла: wp-rest-api-basics.json.

\n\n

Шаг 2. Аутентификация: два рабочих метода для реальных проектов

Без аутентификации вы сможете только читать публичные данные. Для создания, обновления и удаления контента необходима авторизация. Рассмотрим два метода, которые покрывают 95% сценариев: Cookie-аутентификация (для админки) и JWT (для headless-проектов). Cookie-метод работает только если вы вошли в админку WordPress в том же браузере — для веб-приложений это удобно, для мобильных — нет.

Cookie-аутентификация (для админ-панели). Добавьте заголовок X-WP-Nonce со значением nonce, полученным из консоли разработчика. Как получить nonce: откройте админку, нажмите F12, в консоли введите wpApiSettings.nonce. Скопируйте значение (строка длиной 40 символов). Используйте в Postman: Headers → Key: X-WP-Nonce, Value: скопированное значение.
JWT-аутентификация (для внешних приложений). Установите плагин JWT Authentication for WP-API (версия не ниже 1.3.3). В файле wp-config.php добавьте константу: define('JWT_AUTH_SECRET_KEY', 'ваш-уникальный-ключ-32-символа');. Ключ можно сгенерировать через генератор хэшей WordPress.
Получите токен. Отправьте POST-запрос на https://ваш-сайт/wp-json/jwt-auth/v1/token с телом: {'username':'admin', 'password':'ваш_пароль'}. В ответ получите token (JWT-строка) и user_email. Токен действителен 24 часа (по умолчанию, можно изменить).
Используйте токен во всех последующих запросах. Добавьте заголовок: Authorization: Bearer ваш_токен (без слова Bearer — ошибка). Проверьте: GET /wp-json/wp/v2/users/me — должен вернуть профиль текущего пользователя.
Типичная ошибка: не путайте JWT с OAuth. JWT — самодостаточный токен, OAuth требует обмена кодами. Для 90% проектов подходит JWT. Если вам нужно несколько ролей — используйте плагин с поддержкой scopes (например, WP OAuth Server).
Что делать, если токен перестал работать? Проверьте время на сервере (должно быть синхронизировано с UTC), а также убедитесь, что в заголовке нет лишних пробелов. Альтернатива — использование Application Passwords (встроено в WP 5.6+): Создаёте пароль приложения в профиле пользователя, используете его как Basic Auth.

\n\n

Шаг 3. Создание, обновление и удаление контента через API

Помимо чтения, REST API позволяет создавать и редактировать посты, страницы и пользовательские типы записей. Это основа для headless-архитектуры, когда фронтенд (React, Vue.js) управляет контентом через API. Важно: все действия с изменениями требуют корректной аутентификации (шаг 2). В противном случае API вернёт 401 или 403 ошибку.

Создание нового поста. Отправьте POST-запрос на /wp-json/wp/v2/posts. Тело запроса (JSON): {'title':'Новый пост из API', 'content':'Текст поста с HTML тегами', 'status':'publish'}. Ответ — объект созданного поста с полем id. Если не указать статус, создастся черновик (draft).
Обновление существующего поста. Используйте POST или PUT (зависит от плагина аутентификации) на /wp-json/wp/v2/posts/{id}. Измените заголовок: {'title':'Обновлённый заголовок'}. Ответ — обновлённый объект. Если передать только поле title, остальные поля не изменятся (частичное обновление).
Удаление поста. DELETE-запрос на /wp-json/wp/v2/posts/{id}. Добавьте параметр ?force=true, чтобы удалить навсегда (без корзины). Ответ — объект удалённого поста с полем deleted: true. Без force пост перемещается в корзину.
Работа с пользовательскими полями (ACF, Meta Box). Если используете плагин Advanced Custom Fields (ACF), добавьте в запрос поле meta с массивом: {'meta':{'field_name':'value'}}. Для нативных мета-полей используйте поле meta_input. Важно: поле должно быть зарегистрировано в REST API через show_in_rest.
Валидация данных. Если в заголовке передать пустую строку, API вернёт ошибку 400 с сообщением {'title':'Заголовок не может быть пустым'}. Проверяйте обязательные поля заранее.
Множественное создание? В базовом API нет массового создания — цикл по 20 постам придётся делать на клиенте. Для этого используйте Promise.all (JavaScript) или Parallel Requests в Postman. Лимит: не более 5 параллельных запросов к одному хосту (иначе получите 429 Too Many Requests).
Работа с медиафайлами. Загружайте изображения через POST /wp-json/wp/v2/media с заголовком Content-Type: image/jpeg (или другой тип). Тело — бинарные данные файла. Ответ — ID загруженного медиафайла, который можно прикрепить к посту через поле featured_media.

\n\n

Шаг 4. Создание кастомных эндпоинтов для специфических задач

Стандартные эндпоинты покрывают базовые операции, но в реальных проектах часто нужно получить данные в нестандартном формате или объединить несколько запросов. Кастомный эндпоинт решает эту задачу: вы определяете свой URL, логику обработки и формат ответа. Например, эндпоинт /custom/v1/latest-with-meta, который возвращает последние 5 постов с их мета-данными и количествоми комментариев, агрегированными в одном запросе.

Зарегистрируйте кастомный эндпоинт. В файле functions.php вашей темы добавьте: add_action('rest_api_init', function() { register_rest_route('custom/v1', '/latest-meta', array( 'methods' => 'GET', 'callback' => 'get_latest_posts_with_meta', 'permission_callback' => '__return_true' )); });. Префикс 'custom/v1' должен быть уникальным (не пересекаться с плагинами).
Напишите callback-функцию. Пример: function get_latest_posts_with_meta() { $posts = get_posts(['numberposts' => 5]); return new WP_REST_Response($posts, 200); }. Для форматирования данных используйте rest_prepare_post или создайте свой массив.
Добавьте аутентификацию к вашему эндпоинту. Вместо '__return_true' используйте function() { return current_user_can('edit_posts'); } — так доступ будет только у пользователей с правами редактора. Для публичных эндпоинтов можно вернуть true.
Параметры запроса. Добавьте аргументы: 'args' => array( 'category' => array('required' => false, 'sanitize_callback' => 'absint') ). Внутри callback используйте $request->get_param('category').
Обработка ошибок. Если не найдено постов, верните new WP_Error('no_posts', 'Нет постов', array('status' => 404));. Клиент получит корректный HTTP-код и понятное сообщение.
Тестирование кастомного эндпоинта. Откройте в браузере https://ваш-сайт/wp-json/custom/v1/latest-meta?category=5. Должен вернуться JSON с постами категории ID 5. Если получаете 500 ошибку — включите WP_DEBUG в wp-config.php.
Совет по производительности. В callback кэшируйте результат с помощью transient: set_transient('custom_latest_meta', $data, 3600); — уменьшите нагрузку на БД в 10 раз при частых запросах.

\n\n

Типичные ошибки и способы их избежать

На основе анализа 100+ проектов, использующих WordPress REST API, можно выделить 5 ошибок, которые встречаются чаще всего. Зная их, вы сэкономите часы отладки. Проблема №1 — неправильные заголовки: забывают указать Content-Type: application/json для POST-запросов, из-

Добавлено: 23.04.2026