Solucionar el error de REST API en WordPress

Qué significa el error de REST API en WordPress

La REST API es la capa que permite a WordPress intercambiar datos con el editor, plugins, temas y servicios externos. Cuando falla, puede aparecer un aviso en Salud del sitio, errores al guardar entradas o comportamientos extraños en bloques y ajustes.

En resumen: el problema no suele ser “la API” como elemento aislado, sino alguna barrera entre WordPress y el endpoint /wp-json. En muchos casos, la vía de solución pasa por revisar enlaces permanentes, seguridad, caché, autenticación, reglas del servidor y posibles conflictos de plugins o tema.

Causas más habituales del fallo en /wp-json y el editor de bloques

No existe una única causa universal. El fallo puede deberse a un cambio reciente en el sitio, a una política del hosting o a una combinación de configuración y seguridad.

• Enlaces permanentes dañados o reglas de reescritura mal regeneradas.
• Plugins de seguridad, optimización o caché que alteran respuestas de /wp-json.
• Bloqueos por WAF, mod_security o reglas del servidor.
• Errores de autenticación o permisos insuficientes, especialmente con respuestas 401 o 403.
• Problemas del tema o de un plugin que carga código incompatible con la API.
• Errores de servidor, PHP o base de datos que desembocan en 500.

Si el problema aparece tras una actualización, una migración o un cambio de hosting, conviene tomarlo como pista inicial, aunque no demuestra por sí solo cuál es el origen exacto.

Cómo diagnosticar el problema paso a paso sin tocar nada crítico

Antes de hacer cambios en producción, lo prudente es contar con una copia de seguridad reciente o probar en un entorno de staging. Después, puedes seguir esta secuencia de comprobación:

1. Abre el endpoint /wp-json. Si responde con JSON, hay comunicación básica. Si devuelve 401, 403, 404 o 500, la clave está en interpretar ese código.
2. Guarda de nuevo los enlaces permanentes. En Ajustes > Enlaces permanentes, pulsa guardar sin cambiar nada para regenerar reglas de reescritura.
3. Revisa si existe conflicto de plugins o tema. Si puedes, desactiva temporalmente plugins no esenciales y prueba con un tema por defecto en staging.
4. Vacía todas las capas de caché. Incluye caché de plugin, servidor, CDN y navegador, porque una respuesta antigua puede mantener el error.
5. Comprueba si hay bloqueo por WAF o mod_security. Algunos firewalls interceptan peticiones REST y las tratan como sospechosas.
6. Activa depuración y consulta logs. El modo debug y los registros del servidor ayudan a localizar errores de PHP, permisos, timeouts o rutas.

La documentación oficial de WordPress sobre Salud del sitio puede servir como referencia útil para interpretar avisos relacionados con la REST API y otros problemas de configuración.

Qué revisar en plugins, caché, firewall y servidor

Si ya has confirmado que el error persiste, conviene entrar en los puntos donde más suele romperse la comunicación:

• Plugins: revisa seguridad, optimización, cabeceras, autenticación, SEO técnico y constructores visuales. Algunos limitan rutas REST o modifican respuestas.
• Caché: comprueba exclusiones para el panel y para peticiones dinámicas. Una caché mal configurada puede devolver 404 o respuestas incompletas.
• Firewall: si hay WAF, CDN o reglas de hosting, busca eventos bloqueados relacionados con wp-json, métodos HTTP o cabeceras de autenticación.
• Servidor: revisa redirecciones, reglas .htaccess, Nginx, permisos, versión de PHP y límites de recursos.

Como guía rápida: un 401 suele apuntar a autenticación; un 403, a bloqueo o permisos; un 404, a rutas o reescritura; y un 500, a error interno del servidor o del código en ejecución.

Cuándo conviene pedir soporte técnico especializado

Tiene sentido escalar el caso cuando el error solo aparece en producción, afecta a una web activa, bloquea el editor de bloques o depende de capas que no controlas directamente, como firewall del hosting, reglas avanzadas de servidor o integraciones externas.

También conviene pedir ayuda si ya has revisado /wp-json, enlaces permanentes, plugins, tema, caché, WAF y logs, pero el problema sigue sin una causa clara. En esos escenarios, un diagnóstico técnico evita pruebas a ciegas y reduce el riesgo de romper algo más.

Como cierre práctico: empieza por validar la respuesta de /wp-json, interpreta el código de error y revisa seguridad, caché y reescritura antes de tocar configuraciones críticas. Si la web está en producción, no hagas cambios profundos sin copia de seguridad o staging; y si necesitas estabilidad continuada, valorar soporte o mantenimiento WordPress puede ser el siguiente paso razonable.