Faragiri

Aprender La API REST WordPress

Cuatro peticiones sin credenciales contra una instalación real, el ajuste que decide si tu campo aparece, y el requisito de HTTPS que muchos hostings baratos no cumplen.

4Secciones
4Minutos
5Profundidad

Toda instalación de WordPress contesta una API REST así nadie la haya pedido. Medido en un sitio real el 2026-09-05, 195 rutas están registradas, y sin ninguna autenticación: GET /wp/v2/posts contesta 200, GET /wp/v2/users contesta 200, GET /wp/v2/settings contesta 401, y POST /wp/v2/posts contesta 401.

La segunda de esas es la que hay que mirar. Leer contenido es público por defecto, y eso incluye el listado con los nombres y los alias de quien haya publicado. Eso es a propósito, y también es una lista de usuarios válidos para cualquiera que esté probando contraseñas.

Usarla como backend, y las cuatro cosas que conviene saber

  • Un tipo de contenido personalizado solo aparece en la API si se registró con 'show_in_rest' => true, y lo mismo pasa con los campos de metadatos y las taxonomías. Por eso un campo existe en el panel y no en la respuesta
  • register_rest_field agrega un campo calculado a una ruta que ya existe, lo que evita pedir un segundo recurso por algo que se puede derivar
  • _fields=id,title,link en cualquier petición recorta la respuesta, algo que importa porque el objeto de entrada por defecto pesa
  • La paginación va en los encabezados, X-WP-Total y X-WP-TotalPages, no en el cuerpo, así que un cliente que solo lee el JSON no tiene forma de saber cuántas páginas hay

Los nombres de las rutas valen la pena leerlos una vez. /wp/v2/ es el espacio del núcleo, y un plugin que registra el suyo propio aparece como /su-nombre/v1/, así que la lista de espacios de nombres de una instalación es la lista de todo lo que tiene una opinión sobre tus datos.

Backend en cuatro piezas

Cómo responde la API REST cuando se usa como origen de datos

Cada parte del pedido y de la respuesta decide qué datos salen, cuánto pesa el JSON y cómo se pagina.

/api/wp/v2/posts?_fields=id,title,link
  1. 01/wp/v2/ frente a /su-nombre/v1/
  2. 02'show_in_rest' => true
  3. 03register_rest_field
  4. 04_fields=id,title,link
  5. 05X-WP-Total y X-WP-TotalPages
  1. 01Espacios de nombres en la rutaEl núcleo vive en /wp/v2/ y cada plugin con rutas propias suma su espacio de nombres
  2. 02Visibilidad de tipos, metadatos y taxonomíasSin esta opción al registrar el recurso, existe en el panel pero no aparece en la API
  3. 03Campos calculados en rutas existentesAgrega datos derivados en la misma respuesta para evitar una segunda petición
  4. 04Recorte de carga útil por parámetroReduce el objeto de entrada completo, que por defecto entrega mucho peso
  5. 05Metadatos de paginación en encabezadosNo viajan dentro del cuerpo JSON; un cliente que ignora los encabezados no sabe cuántas páginas hay

Leer la lista de espacios de nombres de una instalación muestra de inmediato todo lo que registra endpoints sobre los datos del sitio.

La autenticación es la parte que WordPress no resuelve solo

La autenticación por cookie solo funciona desde adentro del propio sitio y necesita un nonce, así que cubre el JavaScript del panel y nada más. Para cualquier cosa externa la respuesta integrada son las contraseñas de aplicación: se generan por usuario desde la pantalla de perfil, se envían como autenticación básica HTTP, y se pueden revocar una por una.

Lo que falta configurar afuera

De una herramienta externa a una petición autenticada

La cookie con nonce solo cubre el panel interno; conectar n8n o Make exige armar tres piezas.

Cliente externo (n8n o Make)Sin acceso a la cookie de sesión ni al nonce del panel
  1. 01Usuario propio para integrarCreado solo para la automatización, con el rol más bajo que alcance
  2. 02Contraseña de aplicaciónGenerada en el perfil del usuario, enviada por Basic Auth y revocable por separado
  3. 03Certificado SSL obligatorioSin HTTPS la API rechaza la contraseña de aplicación desde la primera llamada
Petición autenticada a la APIAcceso externo con el permiso mínimo necesario

En hosting compartido económico sin SSL activo por defecto, la integración falla el primer día aunque las credenciales estén bien copiadas.

Son una credencial real con todos los permisos de esa cuenta, así que conviene que la cuenta que las usa sea una creada para la integración, con el rol más bajo que funcione. Y hay un requisito que el panel no avisa: sin certificado SSL, la API rechaza la contraseña de aplicación, porque enviarla es enviar una contraseña en cada petición y eso solo es aceptable sobre HTTPS. Bastante hosting compartido barato de la región todavía entrega el sitio sin certificado activado por defecto, y ese es el motivo real por el que una integración con n8n o con Make deja de funcionar el primer día.

Qué usar para no adivinar la ruta

wp rest, parte de WP-CLI y gratis, lista las rutas que una instalación de verdad expone y las llama desde la línea de comandos con los permisos de un usuario elegido. Reemplaza adivinar la URL y recibir un 404 que puede significar tanto que la ruta no existe como que el recurso no está.

Dos reemplazos integrados

Herramientas nativas para explorar rutas y autenticar sin terceros

WordPress y WP-CLI ya traen lo necesario para inspeccionar endpoints reales y dejar atrás plugins de JWT.

  • wp rest en WP-CLIGratis e incluido para descubrir y probar rutas
    • Lista las rutas reales que expone la instalación
    • Ejecuta llamadas desde consola con permisos de un usuario
    • Evita adivinar URLs y confundir ruta ausente con recurso 404
API REST sin suposiciones
  • Contraseñas de aplicaciónIntegradas desde WordPress 5.6 sin plugins extra
    • Reemplazan plugins de JWT de terceros
    • Mantienen la autenticación dentro del núcleo
    • Facilitan auditar y retirar integraciones heredadas

Si una instalación todavía depende de un plugin externo de JWT y no usa contraseñas de aplicación, conviene revisar esa deuda antes de ampliarla.

Las contraseñas de aplicación son la segunda, gratis e integradas desde WordPress 5.6. Reemplazan instalar un plugin de JWT, que era la respuesta anterior y ponía la autenticación de todo el sitio en manos de código de un tercero. Si una instalación tiene uno de esos plugins y no usa contraseñas de aplicación, vale la pena revisarlo en vez de seguir extendiéndolo.

La API abierta que nadie activó a propósito

El estancamiento es descubrir que la API está abierta después de que el sitio ya está en producción. Nadie la activó, viene así de fábrica, y el listado de usuarios de arriba es el hallazgo que aparece en la revisión de seguridad de un cliente. La reacción habitual es instalar un plugin que apaga toda la API, y eso rompe el editor de bloques, porque el editor mismo es un cliente de esta API.

Cuatro peticiones, ninguna credencial

Lo que un desconocido puede leer de una instalación que nadie configuró

Cada fila se envió contra un sitio real sin ninguna autenticación, y el estado es lo que contestó.

  1. SíLas entradas, con su contenido200. Es el diseño, y el editor de bloques depende de estoSí
  2. SíEl listado de usuarios que han publicado200. Nombres y alias, que son nombres de usuario válidosSí
  3. NoLos ajustes del sitio401. Leer esto necesita una credencialNo
  4. NoCrear una entrada401. Toda escritura la necesitaNo
  5. Sin revisarSi tus campos personalizados están ahíNadie lo revisó. Solo show_in_rest decide, y su valor por defecto es falsoSin revisar

La fila sin respuesta corta para los dos lados: un campo que querías expuesto puede faltar, y un campo en el que nunca pensaste puede ser público. La única forma de saberlo es leer la respuesta, no la pantalla del panel.

El arreglo proporcionado es más angosto: filtrar la ruta de usuarios para exigir autenticación y dejar el resto tal cual. Decidir a propósito qué debería ser público, porque el contenido lo es por defecto, y revisar los códigos de estado reales en vez de suponerlos. Lo que ese mismo sitio entrega a un navegador es Temas, los hooks que filtran estas respuestas son Plugins, y las convenciones que sigue esta API son las de REST.

Al lado de esto

Arriba de esto