¿Qué es la REST API de WordPress y por qué falla?
La REST API es una herramienta fundamental en WordPress que permite que las aplicaciones y scripts se comuniquen con tu sitio web. Es utilizada intensamente por el editor de bloques (Gutenberg), aplicaciones móviles y muchos plugins avanzados. Cuando aparece el mensaje de que la REST API ha encontrado un error, tu panel de administración y ciertas funciones del frontend pueden dejar de responder adecuadamente.
Causas comunes del fallo en la REST API
- Problemas de redirección o configuración incorrecta en archivos .htaccess.
- Bloqueos causados por plugins de seguridad o cortafuegos (firewalls).
- Versiones de PHP obsoletas en el servidor de hosting.
- Conflictos con plugins de terceros que interfieren en las solicitudes HTTP.
Método 1: Comprobar y actualizar los enlaces permanentes (Permalinks)
Uno de los motivos más frecuentes por los cuales falla la REST API es una alteración en la estructura de las URLs del sitio. Para solucionarlo, sigue estos pasos:
- Inicia sesión en tu panel de administración de WordPress.
- Dirígete a
Ajustes > Enlaces permanentesen el menú lateral. - No realices ningún cambio en la estructura; simplemente desplázate hasta el final de la página y haz clic en el botón Guardar cambios.
- Esto regenerará automáticamente el archivo
.htaccessy restaurará las reglas de reescritura de la API.
Método 2: Desactivar temporalmente los plugins de seguridad
Muchos plugins de seguridad (como Wordfence, iThemes Security o Sucuri) bloquean las solicitudes REST API si consideran que provienen de una fuente sospechosa o si hay una regla mal configurada.
- Ve a
Plugins > Plugins instaladosen tu escritorio de WordPress. - Desactiva temporalmente cualquier plugin de seguridad o cortafuegos activo.
- Vuelve a comprobar el estado de salud de tu sitio en
Herramientas > Salud del sitiopara verificar si el error de la REST API ha desaparecido. - Si el problema se resuelve, revisa la configuración de dicho plugin para permitir las llamadas legítimas a la API.
Método 3: Verificar la versión de PHP y la configuración del servidor
Una versión de PHP desactualizada o límites de memoria insuficientes pueden interrumpir las peticiones HTTP que realiza la REST API. Asegúrate de cumplir con los siguientes requisitos técnicos:
- Accede al panel de control de tu hosting (cPanel o Plesk).
- Busca la herramienta de selección de versión de PHP y actualiza tu sitio a PHP 8.0 o superior.
- Aumenta el límite de memoria RAM para WordPress editando el archivo
wp-config.phpañadiendo la siguiente línea antes de la sentencia que dice '¡Eso es todo, deja de editar!':
define('WP_MEMORY_LIMIT', '256M');