Imagina que entras a tu panel de administración de WordPress un martes por la mañana. Todo parece normal, pero al intentar editar una entrada, el editor de bloques (Gutenberg) se queda en blanco, o peor aún, te muestra un mensaje críptico como: «La actualización ha fallado. Error: No se ha podido completar la solicitud de la API REST«.
Acto seguido, visitas la pestaña de Salud del Sitio (Site Health) y allí, con un llamativo fondo naranja, WordPress te confirma tus peores sospechas: «Se ha detectado un error en la API REST».
Si esto te resulta familiar, o simplemente quieres estar preparado para cuando ocurra, has llegado al lugar indicado. Este artículo no es una simple lista de soluciones mágicas. Es una guía de diagnóstico visual y práctico diseñada para que entiendas qué es la REST API, por qué falla y, lo más importante, cómo solucionarlo paso a paso sin necesidad de ser un experto programador.
Prepárate para convertirte en un detective y preservar la salud del sitio WordPress. Coge papel y lápiz (virtual) y empecemos.
Antes de lanzarnos a tocar archivos o desactivar plugins a ciegas, dediquemos 2 minutos a entender el «motor» que falla.
Piensa en tu web WordPress como un restaurante:
Desde la llegada del editor de bloques (Gutenberg) en WordPress 5.0, la API REST se volvió esencial. Cada vez que añades un bloque, guardas un borrador o actualizas tu sitio, se envían y reciben peticiones a través de rutas como `tuweb.com/wp-json/`.
Por lo tanto, un error en la REST API significa que el sistema de comunicación interna de tu web está roto o bloqueado. Las consecuencias van desde un simple aviso molesto hasta la imposibilidad de crear contenido nuevo o que tus plugins más importantes dejen de funcionar.
> Dato clave para el SEO: Una REST API rota puede impedir que herramientas como Yoast SEO o Rank Math actualicen sus datos o que servicios externos (como aplicaciones móviles) se conecten correctamente con tu sitio.
No siempre el error se presenta con un mensaje claro. Aquí tienes los síntomas más habituales. Si reconoces alguno, es muy probable que tengas un problema con `wp-json`.
Cada síntoma tiene una causa raíz. En lugar de probar 50 soluciones aleatorias, diagnosticaremos el problema basándonos en el tipo de error que muestra WordPress.
Aquí empieza la acción. Sigue este flujo de diagnóstico paso a paso y aprende a cómo arreglar API REST. Te recomiendo hacerlo en un entorno de pruebas (staging) si tu web es crítica.
Esta es tu prueba de fuego. Abre una pestaña de incógnito en tu navegador y visita: `https://tudominio.com/wp-json/`
Si el paso 1 fue exitoso (respuesta JSON), el problema es de permisos o de una ruta específica. Para comprobarlo:
Si ves un error `401` aquí, es muy probable que un plugin de caché (como WP Rocket o W3 Total Cache) esté sirviendo páginas estáticas a usuarios logueados o que haya una mezcla de `http://` y `https://`. Ve a la Solución D.
Este es el más fácil y el que tiene más probabilidad de éxito. WordPress ha perdido sus reglas de enlaces permanentes.
¿Cómo lo arreglas?
1. Ve a Ajustes > Enlaces permanentes.
2. No cambies nada. Simplemente haz clic en el botón «Guardar cambios».
3. ¡Listo! Esto regenera el archivo `.htaccess` (en Apache) o refresca las reglas en Nginx. Vuelve a probar `/wp-json/`.
Un `403` es una orden de «Prohibido». Lo más común es que un plugin de seguridad o el firewall de tu hosting (ModSecurity) esté bloqueando las peticiones a la API.
Diagnóstico rápido:
¿Funcionó? El culpable es el plugin que acabas de desactivar. Ve a su configuración y busca una opción llamada «Bloquear acceso a la API REST», «Protección de la API» o similar y desactívala.
Si no funcionó: Contacta con tu soporte de hosting. Pídeles amablemente que desactiven temporalmente ModSecurity para probar. Si ese es el problema, ellos te indicarán cómo crear una regla de excepción.
Un error 500 es un «error interno del servidor». Es como si la cocina se incendiara al intentar preparar tu pedido. La causa casi siempre es un plugin o tema con código defectuoso.
Solución por descarte (modo hospital):
Este es el más traicionero. La API funciona para visitantes, pero falla para usuarios logueados o al guardar.
Solución paso a paso:
Solución de emergencia (añadir código a `wp-config.php`):
A veces, WordPress no detecta bien las rutas. Abre tu archivo `wp-config.php` (vía FTP) y **justo antes del `/* eso es todo, deja de editar */`**, añade esta línea:
define('REST_API_DIR', ABSPATH . 'wp-includes/rest-api/');
Esto a veces fuerza la correcta localización de los archivos de la API.
Has seguido el protocolo como un profesional, pero el error persiste. No te desesperes. Quedan dos cartas bajo la manga:
El error de REST API en WordPress puede parecer un monstruo de tres cabezas, pero como has visto, con un método de diagnóstico claro y las herramientas adecuadas, es un problema que puedes identificar y solucionar por ti mismo la mayoría de las veces.
Recuerda la máxima del administrador WordPress: «Diagnostica antes de actuar». No desactives todo tu sitio a lo loco. Usa las pruebas que te he enseñado: visita `/wp-json/`, comprueba los códigos de error y aísla por descarte.
Mantener tu API REST sana es sinónimo de tener un WordPress moderno, funcional y preparado para el futuro. Ahora que tienes esta guía, la próxima vez que veas ese aviso en «Salud del Sitio», sonreirás, porque sabrás exactamente qué hacer.
Etiquetas: Error REST API WordPress, solucionar REST API, wp-json error, fallo editor bloques, salud del sitio WordPress, cómo arreglar REST API.
#RESTAPIWordpress #errorRESTAPI #SolucionerrorRESTAPI #ArreglarerrorRESTAPI #FalloEditorBloques
Diseño Web Desarrollo Web Páginas web Mantenimiento web Hosting y Dominio Posicionamiento Web Autónomos Diseño Web en Sevilla. 5 beneficios para Autónomos en 2026 ¿Eres
Mantenimiento web Páginas web Hosting y Dominio Posicionamiento Web Posicionamiento SEO Diseño Gráfico Autónomos Guía visual definitiva: Por qué falla y aparece el error REST
Edición de Vídeos Posicionamiento Web Posicionamiento SEO Páginas web Mantenimiento web Diseño Gráfico Autónomos Edición de Vídeos para Autónomos y PYMES 3 beneficios del marketing