WP REST API: 5 ошибок, из-за которых headless-проект ломается на интеграции

WP REST API часто воспринимают как «просто JSON-эндпоинты». На практике всё упирается в структуру данных и контракт между WordPress и фронтом. Если его не зафиксировать, фронт начнёт зависеть от случайных полей, а любая правка в админке будет ломать интерфейс.

Частые ошибки:
— тянут лишние поля из wp-json и не контролируют payload;
— не нормализуют ACF, таксономии и медиа в единую схему;
— используют публичные запросы там, где нужен отдельный слой авторизации;
— строят фронт на сырых ответах, без адаптера между API и UI;
— забывают про кеширование и переизбыток запросов.

Для стабильной интеграции держите простой принцип: WP отвечает за контент, фронт — за формат отображения. Между ними должен быть слой маппинга, который превращает ответ API в предсказуемую модель данных. Тогда можно менять поля, шаблоны и источники контента без переписывания всего приложения.

Если проект растёт, сразу определите: какие эндпоинты публичные, какие поля обязательны, какие ответы считаются совместимыми. Это экономит недели на отладке и делает WP REST API не «слабым местом», а нормальной точкой интеграции.