REST API в теме WordPress: 4 ошибки, которые ломают интеграции и фронт

REST API в теме WordPress: 4 ошибки, которые ломают интеграции и фронт

REST API в теме нужен не только для «модных» SPA. Через него удобно отдавать данные в блоки, подгружать контент без перезагрузки и связывать тему с внешними сервисами. Но почти все проблемы начинаются с мелочей в теме: маршрут есть, а ответ нестабилен.

— Не проверяют права доступа. Публичный endpoint часто начинает отдавать лишнее: мета-поля, черновики, внутренние ID. Для каждого ответа задавайте явную схему и фильтруйте поля.
— Возвращают «сырой» WP_Query. Клиенту нужен предсказуемый JSON, а не массив всего подряд. Нормализуйте структуру: title, link, excerpt, image, date.
— Игнорируют кэширование. Если endpoint дергают из фронта, не гоняйте тяжелые запросы на каждый рендер. Кэшируйте результат по ключу и сбрасывайте его при сохранении поста.
— Не обрабатывают ошибки. Пустой массив и 500 для клиента выглядят одинаково плохо. Возвращайте понятный код и сообщение, чтобы фронт мог показать запасной UI.

Если endpoint нужен только теме, держите логику рядом с шаблонами и регистрируйте маршруты в одном месте. Так проще сопровождать код и быстрее искать, где сломалась интеграция.